SetExternalDigestSignCallback

Segurança e assinaturas

Descrição

Regista a chamada de retorno síncrona utilizada pelos processos de assinatura externa de resumos da DLL ou 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 que expõe `SignDigest` ou um ponteiro de função DLL que utiliza a assinatura apresentada acima
UserData	Valor opaco da DLL novamente passado sem alterações em cada chamada de retorno

Contrato da chamada de retorno

O método do objeto ActiveX é SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm) e devolve uma variante de matriz de bytes que contém a assinatura em bruto

A chamada de retorno da DLL não escreve mais de SignatureCapacity bytes e devolve o número escrito, ou um valor não positivo em caso de falha

DigestAlgorithm utiliza os códigos de SetSignProcessDigestAlgorithm, e SignatureAlgorithm utiliza os códigos de formato de assinatura externa documentados por SetSignProcessExternalDigestSigner

A chamada de retorno recebe apenas um resumo de comprimento fixo e nunca recebe os intervalos de bytes do PDF nem os bytes dos atributos autenticados

Valores devolvidos

1	O registo da chamada de retorno foi atualizado
0	A instância da DLL era inválida

Consulte também

OnExternalDigestSign, SetSignProcessExternalDigestSigner