SetExternalDigestSignCallback
Segurança e assinaturas
Descrição
Registra o callback síncrono usado por processos de assinatura por digest externo da DLL ou do ActiveX
Sintaxe
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);
Parâmetros
| Callback | Objeto ActiveX expondo SignDigest, ou um ponteiro de função DLL usando a assinatura mostrada acima |
|---|---|
| UserData | Valor opaco da DLL repassado inalterado em todo callback |
Contrato de callback
O método do objeto ActiveX é SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm) e retorna uma variant de byte array contendo a assinatura bruta. O callback da DLL grava no máximo
SignatureCapacity
bytes DigestAlgorithm e retorna o número gravado, ou um valor não positivo em caso de falha. SetSignProcessDigestAlgorithm usa os códigos SignatureAlgorithm e SetSignProcessExternalDigestSigner usa os códigos de formato de assinatura externa documentados por
SetSignProcessExternalDigestSigner O callback recebe apenas um digest de comprimento fixo e nunca recebe os byte ranges do PDF nem os bytes de atributos autenticados
Valores retornados
| 1 | O registro do callback foi atualizado |
|---|---|
| 0 | The DLL instance was invalid |