SetExternalDigestSignCallback
Seguridad y firmas
Descripción
Registra la devolución de llamada sincrónica utilizada por procesos externos de firma de resúmenes de DLL o ActiveX
Sintaxis
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 expone SignDigest, o un puntero de función DLL que usa la firma mostrada arriba |
|---|---|
| UserData | Valor opaco de DLL que se devuelve sin cambios en cada devolución de llamada |
Contrato de la función callback
El método del objeto ActiveX es SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm) y devuelve una variante de matriz de bytes que contiene la firma sin procesar
La devolución de llamada de DLL no escribe más de SignatureCapacity bytes y devuelve el número escrito, o un valor no positivo si falla
DigestAlgorithm usa los códigos de SetSignProcessDigestAlgorithm y SignatureAlgorithm usa los códigos de formato de firma externa documentados por SetSignProcessExternalDigestSigner
La devolución de llamada recibe únicamente un resumen de longitud fija y nunca recibe los intervalos de bytes del PDF ni los bytes de atributos autenticados
Valores devueltos
| 1 | Se actualizó el registro de devolución de llamada |
|---|---|
| 0 | La instancia de DLL no era válida |