SetSignProcessCNGKeyFromFile
Seguridad y firmas
Descripción
Carga un certificado X.509 codificado en DER desde un archivo y asocia una clave privada NCrypt con nombre a un proceso de firma de PDF
Sintaxis
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 | Ruta a un certificado X.509 RSA o ECDSA codificado en DER |
|---|---|
| ProviderName | Nombre del proveedor de almacenamiento de claves de Windows, o una cadena vacía para el proveedor de software de Microsoft |
| KeyName | Nombre de clave persistente reconocido por el proveedor |
| UseMachineKey | True o distinto de cero para usar el ámbito de clave de máquina |
| AllowUI | True o un valor distinto de cero para permitir la interacción del proveedor |
Valores devueltos
| 1 | Se leyó el certificado y se adjuntó la configuración |
|---|---|
| 0 | El archivo, id. de proceso o nombre de clave no era válido |
Observaciones
La DLL también exporta DLSetSignProcessCNGKeyFromFileA para rutas y nombres ANSI
Los bytes del certificado se conservan en el proceso de firma, mientras que la clave privada permanece dentro de su proveedor