SetSignProcessCNGKeyFromFile
Segurança e assinaturas
Descrição
Carrega um certificado X.509 codificado em DER de um arquivo e anexa uma chave privada NCrypt nomeada a um processo de assinatura PDF
Sintaxe
Delphi
Function TPDFlib.SetSignProcessCNGKeyFromFile(SignProcessID: Integer; Const CertificateFile, ProviderName, KeyName: WideString; UseMachineKey, AllowUI: Boolean): Integer;
ActiveX
Function PDFlib::SetSignProcessCNGKeyFromFile(SignProcessID As Long, CertificateFile As String, ProviderName As String, KeyName As String, UseMachineKey As Long, AllowUI As Long) As Long
DLL
int DLSetSignProcessCNGKeyFromFile(int InstanceID, int SignProcessID, const wchar_t* CertificateFile, const wchar_t* ProviderName, const wchar_t* KeyName, int UseMachineKey, int AllowUI);
Parâmetros
| CertificateFile | Path to a DER-encoded RSA or ECDSA X.509 certificate |
|---|---|
| ProviderName | Nome do provider de armazenamento de chaves do Windows, ou uma string vazia para o provider de software da Microsoft |
| KeyName | Nome de chave persistente reconhecido pelo provider |
| UseMachineKey | True ou diferente de zero para usar escopo de chave de máquina |
| AllowUI | True ou diferente de zero para permitir interação do provedor |
Valores retornados
| 1 | O certificado foi lido e a configuração foi anexada |
|---|---|
| 0 | O arquivo, o id do processo ou o nome da chave era inválido |
Observações
A DLL também exporta DLSetSignProcessCNGKeyFromFileA para caminhos e nomes ANSI
Os bytes do certificado são retidos pelo processo de assinatura, enquanto a chave privada permanece dentro do provedor dela