SetExternalDigestSignCallback

Sicherheit und Signaturen

Beschreibung

Registriert die synchrone Rückruffunktion, die von externen DLL- oder ActiveX-Prozessen zur Digest-Signierung verwendet wird

Syntax

ActiveX

Function PDFlib::SetExternalDigestSignCallback(Callback As Object) As Long

DLL

int DLSetExternalDigestSignCallback(int InstanceID, void* Callback, void* UserData);
int __stdcall Callback(int SignProcessID, const char* Digest, int DigestLength, int DigestAlgorithm, int SignatureAlgorithm, char* Signature, int SignatureCapacity, void* UserData);

Parameter

Callback	ActiveX-Objekt, das `SignDigest` bereitstellt, oder ein DLL-Funktionszeiger mit der oben gezeigten Signatur
UserData	Undurchsichtiger DLL-Wert, der bei jedem Rückruf unverändert zurückgegeben wird

Rückrufvertrag

Die ActiveX-Objektmethode ist SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm) und gibt eine Bytearray-Variante mit der Rohsignatur zurück

Die DLL-Rückruffunktion schreibt höchstens SignatureCapacity Bytes und gibt die geschriebene Anzahl oder bei einem Fehler einen nicht positiven Wert zurück

DigestAlgorithm verwendet die Codes von SetSignProcessDigestAlgorithm, und SignatureAlgorithm verwendet die unter SetSignProcessExternalDigestSigner dokumentierten Codes für externe Signaturformate

Der Rückruf empfängt nur einen Digest fester Länge und niemals die PDF-Bytebereiche oder Bytes authentifizierter Attribute

Rückgabewerte

1	Die Registrierung der Rückruffunktion wurde aktualisiert
0	Die DLL-Instanz war ungültig

Siehe auch

OnExternalDigestSign, SetSignProcessExternalDigestSigner