SetSignProcessCNGKeyByHandle
Sicherheit und Signaturen
Beschreibung
Ordnet einem PDF-Signaturprozess ein NCRYPT_KEY_HANDLE im Besitz des Aufrufers und dessen DER-kodiertes X.509-Zertifikat zu
Dieser Pfad unterstützt Schlüssel, die durch anwendungsspezifischen Erkennungs-, Richtlinien- oder Cloudanbietercode geöffnet wurden, ohne den Schlüssel erneut anhand seines Namens zu öffnen
Syntax
Delphi
Function TPDFlib.SetSignProcessCNGKeyByHandle(SignProcessID: Integer; Const CertificateDER: AnsiString; KeyHandle: TPLIntPtr; AllowUI: Boolean): Integer;Parameter
| CertificateDER | Vollständiges DER-kodiertes RSA- oder ECDSA-X.509-Zertifikat, das dem Schlüssel entspricht |
|---|---|
| KeyHandle | Geöffnetes NCRYPT_KEY_HANDLE, dargestellt als TPLIntPtr |
| AllowUI | True, um Anbieterinteraktion beim Signieren zuzulassen |
Rückgabewerte
| 1 | Das geliehene Handle wurde dem Prozess zugeordnet |
|---|---|
| 0 | Die Prozess-ID, das Zertifikat oder das Handle war ungültig |
Anmerkungen
Der Aufrufer behält das Eigentum und muss das Handle bis zum Abschluss von EndSignProcessTo* gültig halten
Die Bibliothek fragt vor dem Signieren die NCrypt-Algorithmusgruppe ab und prüft die fertige CMS-Signatur anhand des bereitgestellten Zertifikats
Diese handlebreite API ist nur für Delphi verfügbar; DLL- und ActiveX-Aufrufer verwenden die APIs mit Anbieter- und Schlüsselnamen