Xojo Conferences
MBSOct2019CologneDE

DynaPDF Manual - Page 188

Previous Page 187   Index   Next Page 189

Function Reference
Page 188 of 770
However, incremental updates are not supported by DynaPDF that is why only empty signature
fields are imported. Because DynaPDF creates always a completely new PDF file, it makes no sense
to import existing signatures, they would become invalid.
Possible function errors
When trying to sign a PDF file the function must first parse the certificate file before a signature can
be created. This process can fail, due to an invalid file path or due to an unsupported certificate file
format that was passed to the function. The PDF file will be closed and signed if the certificate file
was valid and no other error occurred during the parsing process of the certificate file.
If an error occurred during the parsing process, e.g. invalid certificate file, invalid file path and so on,
the function returns zero and passes an error message to the error callback function if any. All errors
during the parsing process of the certificate file are non-fatal so that the PDF file is still in memory
when the function returns. It is then possible to change the certificate file and trying to sign the PDF
file again.
To determine whether the PDF was already deleted or of it is still in memory call the function
HaveOpenDoc(). The function returns true if the PDF file is in memory. If the function returns false,
the last error was fatal and the PDF file has already been deleted.
The buffer of a memory based PDF file can be returned by GetBuffer() after this function was called.
Note that GetBuffer() does not free the used resources because it returns a pointer to the original
buffer. After the buffer was processed by your application call FreePDF() to free the uses resources.
See also CreateSigFieldAP(), CreateNewPDF(), GetBuffer(), FreePDF().
Remarks:
Further information about digital signatures can be found under Digital Signatures. The appearance
of a signature field can be user defined. See CreateSigFieldAP() for further information.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
CloseAndSignFileExt
Syntax:
LBOOL pdfCloseAndSignFileExt(
const PPDF* IPDF,
// Instance pointer
struct TPDFSigParms* SigParms) // Important parameters
typedef enum
{
htDetached, // Byte ranges of the finish PDF file will be returned
htSHA1
// The SHA1 hash to be signed will be returned
}THashType;
struct TPDFSigParms
{
 

Previous topic: CloseAndSignFileEx, Importing signed PDF files

Next topic: Supported PKCS#7 Format, Hardware Certificates