SetSignProcessCNGKeyFromFile

Sicherheit und Signaturen

Beschreibung

Lädt ein DER-kodiertes X.509-Zertifikat aus einer Datei und ordnet einem PDF-Signaturprozess einen benannten privaten NCrypt-Schlüssel zu

Syntax

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);

Parameter

CertificateFile	Pfad zu einem DER-codierten RSA- oder ECDSA-X.509-Zertifikat
ProviderName	Name des Windows-Schlüsselspeicheranbieters oder eine leere Zeichenfolge für den Microsoft-Softwareanbieter
KeyName	Vom Anbieter verstandener persistenter Schlüsselname
UseMachineKey	True oder ein von null verschiedener Wert zur Verwendung des Computerschlüsselbereichs
AllowUI	True oder ein von null verschiedener Wert, um die Interaktion mit dem Anbieter zuzulassen

Rückgabewerte

1	Das Zertifikat wurde gelesen und die Konfiguration angehängt
0	Die Datei, Prozess-ID oder der Schlüsselname war ungültig

Anmerkungen

Die DLL exportiert außerdem DLSetSignProcessCNGKeyFromFileA für ANSI-Pfade und -Namen

Die Zertifikatbytes werden vom Signaturprozess aufbewahrt, während der private Schlüssel in seinem Anbieter verbleibt

Siehe auch

SetSignProcessCNGKey, SetSignProcessPFXFromFile