SetSignProcessCNGKeyFromFile
Zabezpieczenia i podpisy
Opis
Wczytuje z pliku certyfikat X.509 zakodowany w DER i dołącza nazwany klucz prywatny NCrypt do procesu podpisywania PDF
Składnia
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);
Parametry
| CertificateFile | Ścieżka do certyfikatu X.509 RSA lub ECDSA zakodowanego w DER |
|---|---|
| ProviderName | Nazwa dostawcy magazynu kluczy Windows albo pusty ciąg dla dostawcy programowego Microsoft |
| KeyName | Trwała nazwa klucza rozpoznawana przez dostawcę |
| UseMachineKey | True lub wartość niezerowa wybiera zakres kluczy komputera |
| AllowUI | True lub wartość niezerowa zezwala na interakcję dostawcy |
Wartości zwracane
| 1 | Certyfikat został odczytany, a konfiguracja dołączona |
|---|---|
| 0 | Plik, identyfikator procesu lub nazwa klucza były nieprawidłowe |
Uwagi
DLL eksportuje także DLSetSignProcessCNGKeyFromFileA dla ścieżek i nazw ANSI
Bajty certyfikatu są zachowywane przez proces podpisywania, natomiast klucz prywatny pozostaje u dostawcy