22.03.2015 Views

DLI Implementation and Reference Guide - Datalogics

DLI Implementation and Reference Guide - Datalogics

DLI Implementation and Reference Guide - Datalogics

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

A.140 <strong>DLI</strong> <strong>Implementation</strong> <strong>and</strong> <strong>Reference</strong> <strong>Guide</strong><br />

dlpdfsignaturesetdatacallback<br />

(DLPDFSIGNATURE *signature, void (*dataCallback)(char *, int))<br />

Return Value: void<br />

Description<br />

Parameters<br />

Return Value<br />

This is an optional call for clients using PKCS #7 certificates. A<br />

callback function is supplied for the signature.<br />

• DLPDFSIGNATURE *signature: signature with which<br />

PKCS #7 certificate will be associated<br />

• void (*dataCallback)(char *, int): callback<br />

function, called during the dlpdfdocwritepdf function<br />

call; see Technical Notes below.<br />

void<br />

Exceptions<br />

Header<br />

Related Methods<br />

Availability<br />

dli.h<br />

dlpdfsignaturesetpkcs7cert<br />

dlpdfdocwritepdf<br />

All <strong>DLI</strong>-supported platforms.<br />

Technical Notes<br />

1 The callback is called during the dlpdfdocwritepdf function with binary information from the<br />

PDF file. This information will be in sequential pieces, <strong>and</strong> may be used to generate the PDF document<br />

hash value. The information is supplied as binary values in the character buffer; the length to read is<br />

supplied as the second parameter.<br />

2 A length of 0 (zero) passed in the callback function indicates that no further data is to be read, <strong>and</strong> the<br />

hash may be finalized.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!