SetExternalDigestSignCallback
Sicurezza e firme
Descrizione
Registra la callback sincrona usata dai processi DLL o ActiveX di firma esterna del digest
Sintassi
ActiveX
Function PDFlib::SetExternalDigestSignCallback(Callback As Object) As LongDLL
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);Parametri
| Callback | Oggetto ActiveX che espone SignDigest oppure puntatore a funzione DLL con la firma mostrata sopra |
|---|---|
| UserData | Valore DLL opaco restituito invariato a ogni callback |
Contratto della callback
Il metodo ActiveX è SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm) e restituisce un array di byte variant con la firma grezza
Il callback DLL scrive al massimo SignatureCapacity byte e restituisce il numero scritto oppure un valore non positivo in caso di errore
DigestAlgorithm usa i codici di SetSignProcessDigestAlgorithm e SignatureAlgorithm usa i codici del formato di firma esterna documentati da SetSignProcessExternalDigestSigner
Il callback riceve soltanto un digest di lunghezza fissa e non riceve mai gli intervalli di byte PDF né i byte degli attributi autenticati
Valori restituiti
| 1 | La registrazione della callback è stata aggiornata |
|---|---|
| 0 | L'istanza DLL non era valida |