SetExternalDigestSignCallback
Zabezpieczenia i podpisy
Opis
Rejestruje synchroniczne wywołanie zwrotne używane przez zewnętrzne procesy podpisywania skrótu DLL lub ActiveX
Składnia
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);
Parametry
| Callback | Obiekt ActiveX udostępniający SignDigest albo wskaźnik funkcji DLL o sygnaturze pokazanej powyżej |
|---|---|
| UserData | Nieprzezroczysta wartość DLL przekazywana bez zmian przy każdym wywołaniu zwrotnym |
Kontrakt wywołania zwrotnego
Metoda obiektu ActiveX to SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm); zwraca ona wariant tablicy bajtów zawierający surowy podpis
Wywołanie zwrotne DLL zapisuje nie więcej niż SignatureCapacity bajtów i zwraca liczbę zapisanych bajtów albo wartość niedodatnią w przypadku błędu
DigestAlgorithm używa kodów SetSignProcessDigestAlgorithm, a SignatureAlgorithm używa kodów formatu podpisu zewnętrznego udokumentowanych przez SetSignProcessExternalDigestSigner
Wywołanie zwrotne otrzymuje tylko skrót o stałej długości i nigdy nie otrzymuje zakresów bajtów PDF ani bajtów uwierzytelnionych atrybutów
Wartości zwracane
| 1 | Rejestracja wywołania zwrotnego została zaktualizowana |
|---|---|
| 0 | Instancja DLL była nieprawidłowa |