SetSignProcessCNGKeyFromFile
Seguridad y firmas
Descripción
Carga desde un archivo un certificado X.509 codificado con DER y adjunta 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 de un certificado X.509 RSA o ECDSA codificado en DER |
|---|---|
| ProviderName | Nombre del proveedor de almacenamiento de claves de Windows o cadena vacía para el proveedor de software de Microsoft |
| KeyName | Nombre de clave persistente que reconoce el proveedor |
| UseMachineKey | Verdadero o distinto de cero para utilizar el ámbito de claves de la 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, el identificador de proceso o el nombre de clave no eran válidos |
Observaciones
La DLL también exporta DLSetSignProcessCNGKeyFromFileA para rutas y nombres ANSI
El proceso de firma conserva los bytes del certificado, mientras que la clave privada permanece dentro de su proveedor