SetSignProcessCNGKeyByHandle
Segurança e assinaturas
Descrição
Associa um NCRYPT_KEY_HANDLE pertencente ao chamador e o respetivo certificado X.509 codificado em DER a um processo de assinatura PDF
Este caminho suporta chaves abertas por código de deteção específico da aplicação, de política ou do fornecedor de serviços na nuvem, sem voltar a abrir a chave pelo nome
Sintaxe
Delphi
Function TPDFlib.SetSignProcessCNGKeyByHandle(SignProcessID: Integer; Const CertificateDER: AnsiString; KeyHandle: TPLIntPtr; AllowUI: Boolean): Integer;
Parâmetros
| CertificateDER | Certificado X.509 RSA ou ECDSA completo, codificado em DER, correspondente à chave |
|---|---|
| KeyHandle | NCRYPT_KEY_HANDLE aberto representado como TPLIntPtr |
| AllowUI | Verdadeiro para permitir a interação do fornecedor durante a assinatura |
Valores devolvidos
| 1 | O identificador emprestado foi associado ao processo |
|---|---|
| 0 | O ID do processo, o certificado ou o identificador era inválido |
Observações
O invocador mantém a propriedade e tem de manter o identificador válido até EndSignProcessTo* terminar
A biblioteca consulta o grupo de algoritmos NCrypt antes de assinar e verifica a assinatura CMS concluída em relação ao certificado fornecido
Esta API do tamanho dum identificador destina-se apenas a Delphi; os invocadores DLL e ActiveX utilizam as APIs de fornecedor e nome da chave