SetExternalDigestSignCallback
Безопасность и подписи
Описание
Регистрирует синхронный callback, используемый процессами внешнего подписания дайджестом в DLL или ActiveX
Синтаксис
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);
Параметры
| Callback | Объект ActiveX с SignDigest или указатель на функцию DLL с сигнатурой, показанной выше |
|---|---|
| UserData | Непрозрачное значение DLL, возвращаемое без изменений в каждом колбэке |
Контракт Callback
Метод объекта ActiveX — SignDigest(SignProcessID, Digest, DigestAlgorithm, SignatureAlgorithm), возвращает вариант с массивом байтов, содержащий сырую подписьКолбэк DLL записывает не более
SignatureCapacity
DigestAlgorithm байтов и возвращает число записанных, либо неположительное значение при ошибкеSetSignProcessDigestAlgorithm использует коды SignatureAlgorithm, а SetSignProcessExternalDigestSigner — коды форматов внешней подписи, документированные для
SetSignProcessExternalDigestSigner Callback получает только дайджест фиксированной длины и никогда — байтовые диапазоны PDF или байты аутентифицированных атрибутов
Возвращаемые значения
| 1 | Регистрация callback обновлена |
|---|---|
| 0 | Экземпляр DLL недопустим |