SetSignProcessCNGKeyFromFile

Segurança e assinaturas

Descrição

Carrega um certificado X.509 codificado em DER a partir de um ficheiro e associa uma chave privada NCrypt designada 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	Caminho para um certificado RSA ou ECDSA X.509 codificado em DER
ProviderName	Nome do fornecedor de armazenamento de chaves do Windows, ou uma cadeia vazia para o fornecedor de software da Microsoft
KeyName	Nome de chave persistente compreendido pelo fornecedor
UseMachineKey	True ou um valor diferente de zero para utilizar o âmbito da chave do computador
AllowUI	True ou diferente de zero para permitir a interação do fornecedor

Valores devolvidos

1	O certificado foi lido e a configuração foi associada
0	O ficheiro, 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 mantidos pelo processo de assinatura, enquanto a chave privada permanece no respetivo fornecedor

Consulte também

SetSignProcessCNGKey, SetSignProcessPFXFromFile