SetSignProcessCNGKeyFromFile
Sicurezza e firme
Descrizione
Carica certificato X.509 DER da file e associa una chiave privata NCrypt denominata a un processo di firma
Sintassi
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);
Parametri
| CertificateFile | Percorso di un certificato X.509 RSA o ECDSA con codifica DER |
|---|---|
| ProviderName | Nome del provider di archiviazione chiavi Windows oppure stringa vuota per il provider software Microsoft |
| KeyName | Nome di chiave persistente riconosciuto dal provider |
| UseMachineKey | True o un valore diverso da zero per usare l'ambito della chiave del computer |
| AllowUI | True o un valore diverso da zero per consentire l'interazione con il provider |
Valori restituiti
| 1 | Il certificato è stato letto e la configurazione è stata associata |
|---|---|
| 0 | Il file, l'ID del processo o il nome della chiave non era valido |
Note
La DLL esporta anche DLSetSignProcessCNGKeyFromFileA per percorsi e nomi ANSI
I byte certificato restano nel processo di firma, la chiave privata resta nel provider