SetExternalDigestSignCallback

Sikkerhed og signaturer

Beskrivelse

Registrerer det synkrone callback, der bruges af eksterne digest-signeringsprocesser via DLL eller ActiveX

Syntaks

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

Parametre

Callback	ActiveX-objekt, der eksponerer `SignDigest`, eller en DLL-funktionspointer med den signatur, der er vist ovenfor
UserData	Uigennemsigtig DLL-værdi, der returneres uændret ved hvert callback

Callbackkontrakt

ActiveX-objektmetoden er SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm) og returnerer en bytearrayvariant, der indeholder den rå signatur

DLL-callbacket skriver højst SignatureCapacity bytes og returnerer antallet af skrevne bytes eller en ikke-positiv værdi ved fejl

DigestAlgorithm bruger koderne fra SetSignProcessDigestAlgorithm, og SignatureAlgorithm bruger de eksterne signaturformatkoder, der er dokumenteret af SetSignProcessExternalDigestSigner

Callbacket modtager kun en digest med fast længde og modtager aldrig PDF-byteintervallerne eller bytes med godkendte attributter

Returværdier

1	Callbackregistreringen blev opdateret
0	DLL-instansen var ugyldig

Se også

OnExternalDigestSign, SetSignProcessExternalDigestSigner