PDFVerify Class

Properties   Methods   Events   Config Settings   Errors  

The PDFVerify class verifies PDF signatures.

Syntax

PDFVerify

Remarks

The PDFVerify class verifies electronic signatures over PDF documents. Basic Adobe and PAdES signatures are supported.

PDFVerify validates each signature from two perspectives: the integrity and validity of the signature itself (i.e., its correspondence to the document data it covers), and the validity and trustworthiness of the signing certificate chain. These two signature aspects are generally independent of each other - the signature may be valid but the chain may not be trusted, or the chain may be trusted but the integrity of the signature may be violated. Under normal circumstances, both the signature and the chain must be valid for the signature to be considered good.

Preparing the Validation

For every signature in the document, PDFVerify will fire the SignatureInfo event, allowing you to specify whether you want the component to validate the signature, the chain, or both.

Once SignatureInfo returns, PDFVerify proceeds to the signature validation routine in accordance with the provided settings.

Validation Results

Upon completion of the validation, the SignatureProcessed event is fired, and the validation results are published here as well as in the following fields of the associated PDFSignature object:

• ValidationResult contains the outcome of the signature validation: valid, corrupted, the signing certificate was missing, or failed.
• ChainValidationResult contains the primary result of the chain validation routine: valid, valid but untrusted, invalid, or undefined.
• ChainValidationDetails provides the details of the factors that contributed to the chain validation result, such as an outdated certificate, a missing CRL, or a missing CA certificate.

Checking Signature Coverage

Because of these specifics of the PDF format, it is crucially important to understand which part of the document is covered by a specific signature. Use the CoverageEndsAt field of the associated PDFSignature object to establish the scope of a signature. The revision of the document covered by that specific signature ranges from byte 0 to CoverageEndsAt. Alternatively, you can use the GetSignedVersion method to extract the signed revision to a file.

Chain Validation Setup

Note that these parameters apply to the Sign and Update methods in PDFSign as well as the Verify method in PDFVerify, as all three methods execute the chain validation procedure (if it is enabled).

Validation Policy

The ValidationPolicy property dictates how thoroughly the chain will be validated. It includes options to control which checks the class will perform, allowing you to tailor the validation process to meet your specific security needs. For example, if it is not essential to check each certificate's revocation status, set this property to vpFullNoRevocation.

Revocation

The revocation aspect of chain validation is controlled by the RevocationCheck property, which allows you to choose between and prioritize revocation origins. Note that OCSP sources are often preferred to CRL endpoints because of their real-time capability and the smaller size of the responses they produce.

Trust

The trust aspect of chain validation is controlled by the TrustSources property, which allows you to specify the locations in which the class will search for trust anchors. Local system stores, your own trusted root certificates (via the TrustedCerts property), and Trusted Lists (via the TrustedLists property) are all supported.

Offline Mode

The OfflineMode property provides the ability to sign or verify the document without contacting online sources. If this property is enabled, the class will only use KnownCerts, TrustedCerts, data structures within the document itself, and revocation and Trusted List data that it previously saved to its internal cache when looking for missing validation material.

Property List

The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the class with short descriptions. Click on the links for further details.

Attachments Property (PDFVerify Class)

A collection of all attached files found in the PDF document.

Syntax

• C++
• C
• Qt

SecurePDFList<SecurePDFPDFAttachment>* GetAttachments();
int SetAttachments(SecurePDFList<SecurePDFPDFAttachment>* val);

int securepdf_pdfverify_getattachmentcount(void* lpObj);
int securepdf_pdfverify_setattachmentcount(void* lpObj, int iAttachmentCount);

char* securepdf_pdfverify_getattachmentcontenttype(void* lpObj, int attachmentindex);
int securepdf_pdfverify_setattachmentcontenttype(void* lpObj, int attachmentindex, const char* lpszAttachmentContentType);

char* securepdf_pdfverify_getattachmentcreationdate(void* lpObj, int attachmentindex);
int securepdf_pdfverify_setattachmentcreationdate(void* lpObj, int attachmentindex, const char* lpszAttachmentCreationDate);

int securepdf_pdfverify_getattachmentdata(void* lpObj, int attachmentindex, char** lpAttachmentData, int* lenAttachmentData);
int securepdf_pdfverify_setattachmentdata(void* lpObj, int attachmentindex, const char* lpAttachmentData, int lenAttachmentData);

char* securepdf_pdfverify_getattachmentdescription(void* lpObj, int attachmentindex);
int securepdf_pdfverify_setattachmentdescription(void* lpObj, int attachmentindex, const char* lpszAttachmentDescription);

char* securepdf_pdfverify_getattachmentfilename(void* lpObj, int attachmentindex);
int securepdf_pdfverify_setattachmentfilename(void* lpObj, int attachmentindex, const char* lpszAttachmentFileName);

int securepdf_pdfverify_setattachmentinputstream(void* lpObj, int attachmentindex, SecurePDFStream* sAttachmentInputStream);

char* securepdf_pdfverify_getattachmentmodificationdate(void* lpObj, int attachmentindex);
int securepdf_pdfverify_setattachmentmodificationdate(void* lpObj, int attachmentindex, const char* lpszAttachmentModificationDate);

char* securepdf_pdfverify_getattachmentname(void* lpObj, int attachmentindex);
int securepdf_pdfverify_setattachmentname(void* lpObj, int attachmentindex, const char* lpszAttachmentName);

int securepdf_pdfverify_setattachmentoutputstream(void* lpObj, int attachmentindex, SecurePDFStream* sAttachmentOutputStream);

int64 securepdf_pdfverify_getattachmentsize(void* lpObj, int attachmentindex);

int GetAttachmentCount();
int SetAttachmentCount(int iAttachmentCount);

QString GetAttachmentContentType(int iAttachmentIndex);
int SetAttachmentContentType(int iAttachmentIndex, QString qsAttachmentContentType);

QString GetAttachmentCreationDate(int iAttachmentIndex);
int SetAttachmentCreationDate(int iAttachmentIndex, QString qsAttachmentCreationDate);

QByteArray GetAttachmentData(int iAttachmentIndex);
int SetAttachmentData(int iAttachmentIndex, QByteArray qbaAttachmentData);

QString GetAttachmentDescription(int iAttachmentIndex);
int SetAttachmentDescription(int iAttachmentIndex, QString qsAttachmentDescription);

QString GetAttachmentFileName(int iAttachmentIndex);
int SetAttachmentFileName(int iAttachmentIndex, QString qsAttachmentFileName);

int SetAttachmentInputStream(int iAttachmentIndex, SecurePDFStream* sAttachmentInputStream);

QString GetAttachmentModificationDate(int iAttachmentIndex);
int SetAttachmentModificationDate(int iAttachmentIndex, QString qsAttachmentModificationDate);

QString GetAttachmentName(int iAttachmentIndex);
int SetAttachmentName(int iAttachmentIndex, QString qsAttachmentName);

int SetAttachmentOutputStream(int iAttachmentIndex, SecurePDFStream* sAttachmentOutputStream);

qint64 GetAttachmentSize(int iAttachmentIndex);

Remarks

This property is used to access the details of all the attached files identified in the document. Use the SaveAttachment method to save attachments from this properties.

This property is not available at design time.

Data Type

SecurePDFPDFAttachment

BlockedCerts Property (PDFVerify Class)

The certificates that must be rejected as trust anchors.

Syntax

• C++
• C
• Qt

SecurePDFList<SecurePDFCertificate>* GetBlockedCerts();
int SetBlockedCerts(SecurePDFList<SecurePDFCertificate>* val);

int securepdf_pdfverify_getblockedcertcount(void* lpObj);
int securepdf_pdfverify_setblockedcertcount(void* lpObj, int iBlockedCertCount);

char* securepdf_pdfverify_getblockedcerteffectivedate(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertexpirationdate(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertextendedkeyusage(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertfingerprint(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertfingerprintsha1(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertfingerprintsha256(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertissuer(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertprivatekey(void* lpObj, int blockedcertindex);

int securepdf_pdfverify_getblockedcertprivatekeyavailable(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertprivatekeycontainer(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertpublickey(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertpublickeyalgorithm(void* lpObj, int blockedcertindex);

int securepdf_pdfverify_getblockedcertpublickeylength(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertserialnumber(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertsignaturealgorithm(void* lpObj, int blockedcertindex);

int securepdf_pdfverify_getblockedcertstore(void* lpObj, int blockedcertindex, char** lpBlockedCertStore, int* lenBlockedCertStore);
int securepdf_pdfverify_setblockedcertstore(void* lpObj, int blockedcertindex, const char* lpBlockedCertStore, int lenBlockedCertStore);

char* securepdf_pdfverify_getblockedcertstorepassword(void* lpObj, int blockedcertindex);
int securepdf_pdfverify_setblockedcertstorepassword(void* lpObj, int blockedcertindex, const char* lpszBlockedCertStorePassword);

int securepdf_pdfverify_getblockedcertstoretype(void* lpObj, int blockedcertindex);
int securepdf_pdfverify_setblockedcertstoretype(void* lpObj, int blockedcertindex, int iBlockedCertStoreType);

char* securepdf_pdfverify_getblockedcertsubjectaltnames(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertthumbprintmd5(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertthumbprintsha1(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertthumbprintsha256(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertusage(void* lpObj, int blockedcertindex);

int securepdf_pdfverify_getblockedcertusageflags(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertversion(void* lpObj, int blockedcertindex);

char* securepdf_pdfverify_getblockedcertsubject(void* lpObj, int blockedcertindex);
int securepdf_pdfverify_setblockedcertsubject(void* lpObj, int blockedcertindex, const char* lpszBlockedCertSubject);

int securepdf_pdfverify_getblockedcertencoded(void* lpObj, int blockedcertindex, char** lpBlockedCertEncoded, int* lenBlockedCertEncoded);
int securepdf_pdfverify_setblockedcertencoded(void* lpObj, int blockedcertindex, const char* lpBlockedCertEncoded, int lenBlockedCertEncoded);

int GetBlockedCertCount();
int SetBlockedCertCount(int iBlockedCertCount);

QString GetBlockedCertEffectiveDate(int iBlockedCertIndex);

QString GetBlockedCertExpirationDate(int iBlockedCertIndex);

QString GetBlockedCertExtendedKeyUsage(int iBlockedCertIndex);

QString GetBlockedCertFingerprint(int iBlockedCertIndex);

QString GetBlockedCertFingerprintSHA1(int iBlockedCertIndex);

QString GetBlockedCertFingerprintSHA256(int iBlockedCertIndex);

QString GetBlockedCertIssuer(int iBlockedCertIndex);

QString GetBlockedCertPrivateKey(int iBlockedCertIndex);

bool GetBlockedCertPrivateKeyAvailable(int iBlockedCertIndex);

QString GetBlockedCertPrivateKeyContainer(int iBlockedCertIndex);

QString GetBlockedCertPublicKey(int iBlockedCertIndex);

QString GetBlockedCertPublicKeyAlgorithm(int iBlockedCertIndex);

int GetBlockedCertPublicKeyLength(int iBlockedCertIndex);

QString GetBlockedCertSerialNumber(int iBlockedCertIndex);

QString GetBlockedCertSignatureAlgorithm(int iBlockedCertIndex);

QByteArray GetBlockedCertStore(int iBlockedCertIndex);
int SetBlockedCertStore(int iBlockedCertIndex, QByteArray qbaBlockedCertStore);

QString GetBlockedCertStorePassword(int iBlockedCertIndex);
int SetBlockedCertStorePassword(int iBlockedCertIndex, QString qsBlockedCertStorePassword);

int GetBlockedCertStoreType(int iBlockedCertIndex);
int SetBlockedCertStoreType(int iBlockedCertIndex, int iBlockedCertStoreType);

QString GetBlockedCertSubjectAltNames(int iBlockedCertIndex);

QString GetBlockedCertThumbprintMD5(int iBlockedCertIndex);

QString GetBlockedCertThumbprintSHA1(int iBlockedCertIndex);

QString GetBlockedCertThumbprintSHA256(int iBlockedCertIndex);

QString GetBlockedCertUsage(int iBlockedCertIndex);

int GetBlockedCertUsageFlags(int iBlockedCertIndex);

QString GetBlockedCertVersion(int iBlockedCertIndex);

QString GetBlockedCertSubject(int iBlockedCertIndex);
int SetBlockedCertSubject(int iBlockedCertIndex, QString qsBlockedCertSubject);

QByteArray GetBlockedCertEncoded(int iBlockedCertIndex);
int SetBlockedCertEncoded(int iBlockedCertIndex, QByteArray qbaBlockedCertEncoded);

Remarks

This property is used to supply a list of compromised or blocked certificates to the class. Note that any chain containing a blocked certificate will fail validation.

This property is not available at design time.

Data Type

SecurePDFCertificate

DecryptionCert Property (PDFVerify Class)

The decryption certificate.

Syntax

• C++
• C
• Qt

SecurePDFCertificate* GetDecryptionCert();
int SetDecryptionCert(SecurePDFCertificate* val);

char* securepdf_pdfverify_getdecryptioncerteffectivedate(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertexpirationdate(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertextendedkeyusage(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertfingerprint(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertfingerprintsha1(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertfingerprintsha256(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertissuer(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertprivatekey(void* lpObj);

int securepdf_pdfverify_getdecryptioncertprivatekeyavailable(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertprivatekeycontainer(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertpublickey(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertpublickeyalgorithm(void* lpObj);

int securepdf_pdfverify_getdecryptioncertpublickeylength(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertserialnumber(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertsignaturealgorithm(void* lpObj);

int securepdf_pdfverify_getdecryptioncertstore(void* lpObj, char** lpDecryptionCertStore, int* lenDecryptionCertStore);
int securepdf_pdfverify_setdecryptioncertstore(void* lpObj, const char* lpDecryptionCertStore, int lenDecryptionCertStore);

char* securepdf_pdfverify_getdecryptioncertstorepassword(void* lpObj);
int securepdf_pdfverify_setdecryptioncertstorepassword(void* lpObj, const char* lpszDecryptionCertStorePassword);

int securepdf_pdfverify_getdecryptioncertstoretype(void* lpObj);
int securepdf_pdfverify_setdecryptioncertstoretype(void* lpObj, int iDecryptionCertStoreType);

char* securepdf_pdfverify_getdecryptioncertsubjectaltnames(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertthumbprintmd5(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertthumbprintsha1(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertthumbprintsha256(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertusage(void* lpObj);

int securepdf_pdfverify_getdecryptioncertusageflags(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertversion(void* lpObj);

char* securepdf_pdfverify_getdecryptioncertsubject(void* lpObj);
int securepdf_pdfverify_setdecryptioncertsubject(void* lpObj, const char* lpszDecryptionCertSubject);

int securepdf_pdfverify_getdecryptioncertencoded(void* lpObj, char** lpDecryptionCertEncoded, int* lenDecryptionCertEncoded);
int securepdf_pdfverify_setdecryptioncertencoded(void* lpObj, const char* lpDecryptionCertEncoded, int lenDecryptionCertEncoded);

QString GetDecryptionCertEffectiveDate();

QString GetDecryptionCertExpirationDate();

QString GetDecryptionCertExtendedKeyUsage();

QString GetDecryptionCertFingerprint();

QString GetDecryptionCertFingerprintSHA1();

QString GetDecryptionCertFingerprintSHA256();

QString GetDecryptionCertIssuer();

QString GetDecryptionCertPrivateKey();

bool GetDecryptionCertPrivateKeyAvailable();

QString GetDecryptionCertPrivateKeyContainer();

QString GetDecryptionCertPublicKey();

QString GetDecryptionCertPublicKeyAlgorithm();

int GetDecryptionCertPublicKeyLength();

QString GetDecryptionCertSerialNumber();

QString GetDecryptionCertSignatureAlgorithm();

QByteArray GetDecryptionCertStore();
int SetDecryptionCertStore(QByteArray qbaDecryptionCertStore);

QString GetDecryptionCertStorePassword();
int SetDecryptionCertStorePassword(QString qsDecryptionCertStorePassword);

int GetDecryptionCertStoreType();
int SetDecryptionCertStoreType(int iDecryptionCertStoreType);

QString GetDecryptionCertSubjectAltNames();

QString GetDecryptionCertThumbprintMD5();

QString GetDecryptionCertThumbprintSHA1();

QString GetDecryptionCertThumbprintSHA256();

QString GetDecryptionCertUsage();

int GetDecryptionCertUsageFlags();

QString GetDecryptionCertVersion();

QString GetDecryptionCertSubject();
int SetDecryptionCertSubject(QString qsDecryptionCertSubject);

QByteArray GetDecryptionCertEncoded();
int SetDecryptionCertEncoded(QByteArray qbaDecryptionCertEncoded);

Remarks

This property is used to provide the certificate used for decryption. Note that this certificate must have a private key associated with it.

This property is not available at design time.

Data Type

SecurePDFCertificate

DocumentCerts Property (PDFVerify Class)

A collection of certificates read from the document during processing.

Syntax

• C++
• C
• Qt

SecurePDFList<SecurePDFCertificate>* GetDocumentCerts();

int securepdf_pdfverify_getdocumentcertcount(void* lpObj);

char* securepdf_pdfverify_getdocumentcerteffectivedate(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertexpirationdate(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertextendedkeyusage(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertfingerprint(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertfingerprintsha1(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertfingerprintsha256(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertissuer(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertprivatekey(void* lpObj, int documentcertindex);

int securepdf_pdfverify_getdocumentcertprivatekeyavailable(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertprivatekeycontainer(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertpublickey(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertpublickeyalgorithm(void* lpObj, int documentcertindex);

int securepdf_pdfverify_getdocumentcertpublickeylength(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertserialnumber(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertsignaturealgorithm(void* lpObj, int documentcertindex);

int securepdf_pdfverify_getdocumentcertstore(void* lpObj, int documentcertindex, char** lpDocumentCertStore, int* lenDocumentCertStore);

char* securepdf_pdfverify_getdocumentcertstorepassword(void* lpObj, int documentcertindex);

int securepdf_pdfverify_getdocumentcertstoretype(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertsubjectaltnames(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertthumbprintmd5(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertthumbprintsha1(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertthumbprintsha256(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertusage(void* lpObj, int documentcertindex);

int securepdf_pdfverify_getdocumentcertusageflags(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertversion(void* lpObj, int documentcertindex);

char* securepdf_pdfverify_getdocumentcertsubject(void* lpObj, int documentcertindex);

int securepdf_pdfverify_getdocumentcertencoded(void* lpObj, int documentcertindex, char** lpDocumentCertEncoded, int* lenDocumentCertEncoded);

int GetDocumentCertCount();

QString GetDocumentCertEffectiveDate(int iDocumentCertIndex);

QString GetDocumentCertExpirationDate(int iDocumentCertIndex);

QString GetDocumentCertExtendedKeyUsage(int iDocumentCertIndex);

QString GetDocumentCertFingerprint(int iDocumentCertIndex);

QString GetDocumentCertFingerprintSHA1(int iDocumentCertIndex);

QString GetDocumentCertFingerprintSHA256(int iDocumentCertIndex);

QString GetDocumentCertIssuer(int iDocumentCertIndex);

QString GetDocumentCertPrivateKey(int iDocumentCertIndex);

bool GetDocumentCertPrivateKeyAvailable(int iDocumentCertIndex);

QString GetDocumentCertPrivateKeyContainer(int iDocumentCertIndex);

QString GetDocumentCertPublicKey(int iDocumentCertIndex);

QString GetDocumentCertPublicKeyAlgorithm(int iDocumentCertIndex);

int GetDocumentCertPublicKeyLength(int iDocumentCertIndex);

QString GetDocumentCertSerialNumber(int iDocumentCertIndex);

QString GetDocumentCertSignatureAlgorithm(int iDocumentCertIndex);

QByteArray GetDocumentCertStore(int iDocumentCertIndex);

QString GetDocumentCertStorePassword(int iDocumentCertIndex);

int GetDocumentCertStoreType(int iDocumentCertIndex);

QString GetDocumentCertSubjectAltNames(int iDocumentCertIndex);

QString GetDocumentCertThumbprintMD5(int iDocumentCertIndex);

QString GetDocumentCertThumbprintSHA1(int iDocumentCertIndex);

QString GetDocumentCertThumbprintSHA256(int iDocumentCertIndex);

QString GetDocumentCertUsage(int iDocumentCertIndex);

int GetDocumentCertUsageFlags(int iDocumentCertIndex);

QString GetDocumentCertVersion(int iDocumentCertIndex);

QString GetDocumentCertSubject(int iDocumentCertIndex);

QByteArray GetDocumentCertEncoded(int iDocumentCertIndex);

Remarks

This property is used to access all certificates encountered during document processing and embedded into the signature(s). When signing or verifying, this properties will be populated automatically during chain validation.

This property is read-only and not available at design time.

Data Type

SecurePDFCertificate

Firewall Property (PDFVerify Class)

A set of properties related to firewall access.

Syntax

• C++
• C
• Qt

SecurePDFFirewall* GetFirewall();
int SetFirewall(SecurePDFFirewall* val);

int securepdf_pdfverify_getfirewallautodetect(void* lpObj);
int securepdf_pdfverify_setfirewallautodetect(void* lpObj, int bFirewallAutoDetect);

int securepdf_pdfverify_getfirewalltype(void* lpObj);
int securepdf_pdfverify_setfirewalltype(void* lpObj, int iFirewallType);

char* securepdf_pdfverify_getfirewallhost(void* lpObj);
int securepdf_pdfverify_setfirewallhost(void* lpObj, const char* lpszFirewallHost);

char* securepdf_pdfverify_getfirewallpassword(void* lpObj);
int securepdf_pdfverify_setfirewallpassword(void* lpObj, const char* lpszFirewallPassword);

int securepdf_pdfverify_getfirewallport(void* lpObj);
int securepdf_pdfverify_setfirewallport(void* lpObj, int iFirewallPort);

char* securepdf_pdfverify_getfirewalluser(void* lpObj);
int securepdf_pdfverify_setfirewalluser(void* lpObj, const char* lpszFirewallUser);

bool GetFirewallAutoDetect();
int SetFirewallAutoDetect(bool bFirewallAutoDetect);

int GetFirewallType();
int SetFirewallType(int iFirewallType);

QString GetFirewallHost();
int SetFirewallHost(QString qsFirewallHost);

QString GetFirewallPassword();
int SetFirewallPassword(QString qsFirewallPassword);

int GetFirewallPort();
int SetFirewallPort(int iFirewallPort);

QString GetFirewallUser();
int SetFirewallUser(QString qsFirewallUser);

Remarks

This is a Firewall-type property, which contains fields describing the firewall through which the class will attempt to connect.

Data Type

SecurePDFFirewall

InputData Property (PDFVerify Class)

A byte array containing the PDF document to process.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetInputData(char* &lpInputData, int &lenInputData);
int SetInputData(const char* lpInputData, int lenInputData);

Unicode (Windows)
INT GetInputData(LPSTR &lpInputData, INT &lenInputData);
INT SetInputData(LPCSTR lpInputData, INT lenInputData);

int securepdf_pdfverify_getinputdata(void* lpObj, char** lpInputData, int* lenInputData);
int securepdf_pdfverify_setinputdata(void* lpObj, const char* lpInputData, int lenInputData);

QByteArray GetInputData();
int SetInputData(QByteArray qbaInputData);

Remarks

This property is used to assign a byte array containing the PDF document to be processed.

This property is not available at design time.

Data Type

Byte Array

InputFile Property (PDFVerify Class)

The PDF file to process.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetInputFile();
int SetInputFile(const char* lpszInputFile);

Unicode (Windows)
LPWSTR GetInputFile();
INT SetInputFile(LPCWSTR lpszInputFile);

char* securepdf_pdfverify_getinputfile(void* lpObj);
int securepdf_pdfverify_setinputfile(void* lpObj, const char* lpszInputFile);

QString GetInputFile();
int SetInputFile(QString qsInputFile);

Default Value

""

Remarks

This property is used to provide a path to the PDF document to be processed.

Data Type

String

KnownCerts Property (PDFVerify Class)

A collection of additional certificates for chain validation.

Syntax

• C++
• C
• Qt

SecurePDFList<SecurePDFCertificate>* GetKnownCerts();
int SetKnownCerts(SecurePDFList<SecurePDFCertificate>* val);

int securepdf_pdfverify_getknowncertcount(void* lpObj);
int securepdf_pdfverify_setknowncertcount(void* lpObj, int iKnownCertCount);

char* securepdf_pdfverify_getknowncerteffectivedate(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertexpirationdate(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertextendedkeyusage(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertfingerprint(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertfingerprintsha1(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertfingerprintsha256(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertissuer(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertprivatekey(void* lpObj, int knowncertindex);

int securepdf_pdfverify_getknowncertprivatekeyavailable(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertprivatekeycontainer(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertpublickey(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertpublickeyalgorithm(void* lpObj, int knowncertindex);

int securepdf_pdfverify_getknowncertpublickeylength(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertserialnumber(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertsignaturealgorithm(void* lpObj, int knowncertindex);

int securepdf_pdfverify_getknowncertstore(void* lpObj, int knowncertindex, char** lpKnownCertStore, int* lenKnownCertStore);
int securepdf_pdfverify_setknowncertstore(void* lpObj, int knowncertindex, const char* lpKnownCertStore, int lenKnownCertStore);

char* securepdf_pdfverify_getknowncertstorepassword(void* lpObj, int knowncertindex);
int securepdf_pdfverify_setknowncertstorepassword(void* lpObj, int knowncertindex, const char* lpszKnownCertStorePassword);

int securepdf_pdfverify_getknowncertstoretype(void* lpObj, int knowncertindex);
int securepdf_pdfverify_setknowncertstoretype(void* lpObj, int knowncertindex, int iKnownCertStoreType);

char* securepdf_pdfverify_getknowncertsubjectaltnames(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertthumbprintmd5(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertthumbprintsha1(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertthumbprintsha256(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertusage(void* lpObj, int knowncertindex);

int securepdf_pdfverify_getknowncertusageflags(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertversion(void* lpObj, int knowncertindex);

char* securepdf_pdfverify_getknowncertsubject(void* lpObj, int knowncertindex);
int securepdf_pdfverify_setknowncertsubject(void* lpObj, int knowncertindex, const char* lpszKnownCertSubject);

int securepdf_pdfverify_getknowncertencoded(void* lpObj, int knowncertindex, char** lpKnownCertEncoded, int* lenKnownCertEncoded);
int securepdf_pdfverify_setknowncertencoded(void* lpObj, int knowncertindex, const char* lpKnownCertEncoded, int lenKnownCertEncoded);

int GetKnownCertCount();
int SetKnownCertCount(int iKnownCertCount);

QString GetKnownCertEffectiveDate(int iKnownCertIndex);

QString GetKnownCertExpirationDate(int iKnownCertIndex);

QString GetKnownCertExtendedKeyUsage(int iKnownCertIndex);

QString GetKnownCertFingerprint(int iKnownCertIndex);

QString GetKnownCertFingerprintSHA1(int iKnownCertIndex);

QString GetKnownCertFingerprintSHA256(int iKnownCertIndex);

QString GetKnownCertIssuer(int iKnownCertIndex);

QString GetKnownCertPrivateKey(int iKnownCertIndex);

bool GetKnownCertPrivateKeyAvailable(int iKnownCertIndex);

QString GetKnownCertPrivateKeyContainer(int iKnownCertIndex);

QString GetKnownCertPublicKey(int iKnownCertIndex);

QString GetKnownCertPublicKeyAlgorithm(int iKnownCertIndex);

int GetKnownCertPublicKeyLength(int iKnownCertIndex);

QString GetKnownCertSerialNumber(int iKnownCertIndex);

QString GetKnownCertSignatureAlgorithm(int iKnownCertIndex);

QByteArray GetKnownCertStore(int iKnownCertIndex);
int SetKnownCertStore(int iKnownCertIndex, QByteArray qbaKnownCertStore);

QString GetKnownCertStorePassword(int iKnownCertIndex);
int SetKnownCertStorePassword(int iKnownCertIndex, QString qsKnownCertStorePassword);

int GetKnownCertStoreType(int iKnownCertIndex);
int SetKnownCertStoreType(int iKnownCertIndex, int iKnownCertStoreType);

QString GetKnownCertSubjectAltNames(int iKnownCertIndex);

QString GetKnownCertThumbprintMD5(int iKnownCertIndex);

QString GetKnownCertThumbprintSHA1(int iKnownCertIndex);

QString GetKnownCertThumbprintSHA256(int iKnownCertIndex);

QString GetKnownCertUsage(int iKnownCertIndex);

int GetKnownCertUsageFlags(int iKnownCertIndex);

QString GetKnownCertVersion(int iKnownCertIndex);

QString GetKnownCertSubject(int iKnownCertIndex);
int SetKnownCertSubject(int iKnownCertIndex, QString qsKnownCertSubject);

QByteArray GetKnownCertEncoded(int iKnownCertIndex);
int SetKnownCertEncoded(int iKnownCertIndex, QByteArray qbaKnownCertEncoded);

Remarks

This property is used to supply a list of additional certificates to the class that might be needed for chain validation. For instance, intermediary CA certificates may be absent from the standard system locations (or there may be no standard system locations) and therefore should be supplied to the class manually.

The purpose of this certificate properties is roughly equivalent to that of the Intermediate Certification Authorities system store in Windows.

Note: Do not add trust anchors or root certificates to this properties; add them to TrustedCerts instead.

This property is not available at design time.

Data Type

SecurePDFCertificate

OfflineMode Property (PDFVerify Class)

Whether the class is operating in offline mode.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetOfflineMode();
int SetOfflineMode(int bOfflineMode);

Unicode (Windows)
BOOL GetOfflineMode();
INT SetOfflineMode(BOOL bOfflineMode);

int securepdf_pdfverify_getofflinemode(void* lpObj);
int securepdf_pdfverify_setofflinemode(void* lpObj, int bOfflineMode);

bool GetOfflineMode();
int SetOfflineMode(bool bOfflineMode);

Default Value

FALSE

Remarks

This property indicates whether the class should operate in offline mode.

In offline mode, the class restricts itself from accessing online Trusted Lists and revocation information sources such as CRLs or OCSP responders. It may be useful to set this property to true if there is a need to verify the completeness of the validation information included within the signature or provided via KnownCerts.

Data Type

Boolean

OutputData Property (PDFVerify Class)

A byte array containing the PDF document after processing.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetOutputData(char* &lpOutputData, int &lenOutputData);

Unicode (Windows)
INT GetOutputData(LPSTR &lpOutputData, INT &lenOutputData);

int securepdf_pdfverify_getoutputdata(void* lpObj, char** lpOutputData, int* lenOutputData);

QByteArray GetOutputData();

Remarks

This property is used to read the byte array containing the produced output after the operation has completed. It will only be set if an output file and output stream have not been assigned via OutputFile and SetOutputStream respectively.

This property is read-only and not available at design time.

Data Type

Byte Array

OutputFile Property (PDFVerify Class)

The path to a local file where the output will be written.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOutputFile();
int SetOutputFile(const char* lpszOutputFile);

Unicode (Windows)
LPWSTR GetOutputFile();
INT SetOutputFile(LPCWSTR lpszOutputFile);

char* securepdf_pdfverify_getoutputfile(void* lpObj);
int securepdf_pdfverify_setoutputfile(void* lpObj, const char* lpszOutputFile);

QString GetOutputFile();
int SetOutputFile(QString qsOutputFile);

Default Value

""

Remarks

This property is used to provide a path where the resulting PDF document will be saved after the operation has completed.

Data Type

String

Overwrite Property (PDFVerify Class)

Whether or not the class should overwrite files.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetOverwrite();
int SetOverwrite(int bOverwrite);

Unicode (Windows)
BOOL GetOverwrite();
INT SetOverwrite(BOOL bOverwrite);

int securepdf_pdfverify_getoverwrite(void* lpObj);
int securepdf_pdfverify_setoverwrite(void* lpObj, int bOverwrite);

bool GetOverwrite();
int SetOverwrite(bool bOverwrite);

Default Value

FALSE

Remarks

This property indicates whether or not the class will overwrite OutputFile, OutputData, or the stream set in SetOutputStream. If set to false, an error will be thrown whenever OutputFile, OutputData, or the stream set in SetOutputStream exists before an operation.

Data Type

Boolean

Password Property (PDFVerify Class)

The password to decrypt the document with.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPassword();
int SetPassword(const char* lpszPassword);

Unicode (Windows)
LPWSTR GetPassword();
INT SetPassword(LPCWSTR lpszPassword);

char* securepdf_pdfverify_getpassword(void* lpObj);
int securepdf_pdfverify_setpassword(void* lpObj, const char* lpszPassword);

QString GetPassword();
int SetPassword(QString qsPassword);

Default Value

""

Remarks

This property is used to provide the user password for decryption. Though it may be different from OwnerPassword, most implementations use the same value for both.

Data Type

String

Proxy Property (PDFVerify Class)

A set of properties related to proxy access.

Syntax

• C++
• C
• Qt

SecurePDFProxy* GetProxy();
int SetProxy(SecurePDFProxy* val);

int securepdf_pdfverify_getproxyauthscheme(void* lpObj);
int securepdf_pdfverify_setproxyauthscheme(void* lpObj, int iProxyAuthScheme);

int securepdf_pdfverify_getproxyautodetect(void* lpObj);
int securepdf_pdfverify_setproxyautodetect(void* lpObj, int bProxyAutoDetect);

char* securepdf_pdfverify_getproxypassword(void* lpObj);
int securepdf_pdfverify_setproxypassword(void* lpObj, const char* lpszProxyPassword);

int securepdf_pdfverify_getproxyport(void* lpObj);
int securepdf_pdfverify_setproxyport(void* lpObj, int iProxyPort);

char* securepdf_pdfverify_getproxyserver(void* lpObj);
int securepdf_pdfverify_setproxyserver(void* lpObj, const char* lpszProxyServer);

int securepdf_pdfverify_getproxyssl(void* lpObj);
int securepdf_pdfverify_setproxyssl(void* lpObj, int iProxySSL);

char* securepdf_pdfverify_getproxyuser(void* lpObj);
int securepdf_pdfverify_setproxyuser(void* lpObj, const char* lpszProxyUser);

int GetProxyAuthScheme();
int SetProxyAuthScheme(int iProxyAuthScheme);

bool GetProxyAutoDetect();
int SetProxyAutoDetect(bool bProxyAutoDetect);

QString GetProxyPassword();
int SetProxyPassword(QString qsProxyPassword);

int GetProxyPort();
int SetProxyPort(int iProxyPort);

QString GetProxyServer();
int SetProxyServer(QString qsProxyServer);

int GetProxySSL();
int SetProxySSL(int iProxySSL);

QString GetProxyUser();
int SetProxyUser(QString qsProxyUser);

Remarks

This property contains fields describing the proxy through which the class will attempt to connect.

Data Type

SecurePDFProxy

RevocationCheck Property (PDFVerify Class)

The kind(s) of revocation check to perform for all chain certificates.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetRevocationCheck();
int SetRevocationCheck(int iRevocationCheck);

Unicode (Windows)
INT GetRevocationCheck();
INT SetRevocationCheck(INT iRevocationCheck);

RC_ALL_CRL(0), 
RC_ALL_OCSP(1), 
RC_ALL_CRLAND_OCSP(2), 
RC_ANY_CRL(3), 
RC_ANY_OCSP(4), 
RC_ANY_CRLOR_OCSP(5), 
RC_ANY_OCSPOR_CRL(6)

int securepdf_pdfverify_getrevocationcheck(void* lpObj);
int securepdf_pdfverify_setrevocationcheck(void* lpObj, int iRevocationCheck);

int GetRevocationCheck();
int SetRevocationCheck(int iRevocationCheck);

Default Value

6

Remarks

This property is used to specify the revocation sources and preferences the class will use during chain validation. Revocation checking is necessary to ensure the integrity of the chain and to obtain up-to-date certificate validity and trust information.

Certificate Revocation Lists (CRLs) and Online Certificate Status Protocol (OCSP) responses serve the same purpose of ensuring that the certificate has not been revoked by the Certificate Authority (CA) at the time of use. Depending on the circumstances and security policy requirements, either one or both of the revocation information source types may be used.

Possible values are:

This property controls the way revocation checks are performed for every certificate in the chain. Typically, certificates come with two types of revocation information sources: CRLs (Certificate Revocation Lists) and OCSP responses. CRLs are static objects periodically published by the CA at some online location. OCSP responders are active online services maintained by the CA that can provide up-to-date information on certificate statuses in near real time.

There are some conceptual differences between the two. CRLs are normally larger in size. Their use involves some latency because there is normally a delay between the time at which a certificate was revoked and the time at which the subsequent CRL mentioning that revocation is published. The benefits of CRLs are that the same object can provide statuses for all certificates issued by a particular CA, and that the whole technology is much simpler than OCSP (and thus is supported by more CAs).

This property allows the validation course to be adjusted by including or excluding certain types of revocation sources from the validation process. The rcAnyOCSPOrCRL setting (give preference to the faster OCSP route and only demand one source to succeed) is a good choice for most typical validation environments. The rcAll* modes are much stricter, and may be used in scenarios where bulletproof validity information is essential.

Note: If no CRL or OCSP endpoints are provided by the CA, the revocation check will be considered successful. This is because the CA chose not to supply revocation information for its certificates, meaning they are considered irrevocable.

Note: Within each of the above settings, if any retrieved CRL or OCSP response indicates that the certificate has been revoked, the revocation check fails.

Data Type

Integer

Signatures Property (PDFVerify Class)

A collection of all the signatures and empty fields found in the PDF document.

Syntax

• C++
• C
• Qt

SecurePDFList<SecurePDFPDFSignature>* GetSignatures();

int securepdf_pdfverify_getpdfsignaturecount(void* lpObj);

char* securepdf_pdfverify_getpdfsignatureauthorname(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturechainvalidationdetails(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturechainvalidationresult(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignatureclaimedsigningtime(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturecoverageendsat(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturehashalgorithm(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignatureprofile(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturereason(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturetype(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturesignercertindex(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturetimestampcertindex(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturetimestamped(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturevalidatedsigningtime(void* lpObj, int pdfsignatureindex);

int securepdf_pdfverify_getpdfsignaturevalidationresult(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturewidgetheight(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturewidgetoffsetx(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturewidgetoffsety(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturewidgetpages(void* lpObj, int pdfsignatureindex);

char* securepdf_pdfverify_getpdfsignaturewidgetwidth(void* lpObj, int pdfsignatureindex);

int GetPDFSignatureCount();

QString GetPDFSignatureAuthorName(int iPDFSignatureIndex);

int GetPDFSignatureChainValidationDetails(int iPDFSignatureIndex);

int GetPDFSignatureChainValidationResult(int iPDFSignatureIndex);

QString GetPDFSignatureClaimedSigningTime(int iPDFSignatureIndex);

int GetPDFSignatureCoverageEndsAt(int iPDFSignatureIndex);

QString GetPDFSignatureHashAlgorithm(int iPDFSignatureIndex);

int GetPDFSignatureProfile(int iPDFSignatureIndex);

QString GetPDFSignatureReason(int iPDFSignatureIndex);

int GetPDFSignatureType(int iPDFSignatureIndex);

int GetPDFSignatureSignerCertIndex(int iPDFSignatureIndex);

int GetPDFSignatureTimestampCertIndex(int iPDFSignatureIndex);

bool GetPDFSignatureTimestamped(int iPDFSignatureIndex);

QString GetPDFSignatureValidatedSigningTime(int iPDFSignatureIndex);

int GetPDFSignatureValidationResult(int iPDFSignatureIndex);

QString GetPDFSignatureWidgetHeight(int iPDFSignatureIndex);

QString GetPDFSignatureWidgetOffsetX(int iPDFSignatureIndex);

QString GetPDFSignatureWidgetOffsetY(int iPDFSignatureIndex);

QString GetPDFSignatureWidgetPages(int iPDFSignatureIndex);

QString GetPDFSignatureWidgetWidth(int iPDFSignatureIndex);

Remarks

This property is used to access the details of all the signatures and empty signature fields identified in the document.

This property is read-only and not available at design time.

Data Type

SecurePDFPDFSignature

TrustedCerts Property (PDFVerify Class)

A collection of trusted certificates for chain validation.

Syntax

• C++
• C
• Qt

SecurePDFList<SecurePDFCertificate>* GetTrustedCerts();
int SetTrustedCerts(SecurePDFList<SecurePDFCertificate>* val);

int securepdf_pdfverify_gettrustedcertcount(void* lpObj);
int securepdf_pdfverify_settrustedcertcount(void* lpObj, int iTrustedCertCount);

char* securepdf_pdfverify_gettrustedcerteffectivedate(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertexpirationdate(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertextendedkeyusage(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertfingerprint(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertfingerprintsha1(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertfingerprintsha256(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertissuer(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertprivatekey(void* lpObj, int trustedcertindex);

int securepdf_pdfverify_gettrustedcertprivatekeyavailable(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertprivatekeycontainer(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertpublickey(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertpublickeyalgorithm(void* lpObj, int trustedcertindex);

int securepdf_pdfverify_gettrustedcertpublickeylength(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertserialnumber(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertsignaturealgorithm(void* lpObj, int trustedcertindex);

int securepdf_pdfverify_gettrustedcertstore(void* lpObj, int trustedcertindex, char** lpTrustedCertStore, int* lenTrustedCertStore);
int securepdf_pdfverify_settrustedcertstore(void* lpObj, int trustedcertindex, const char* lpTrustedCertStore, int lenTrustedCertStore);

char* securepdf_pdfverify_gettrustedcertstorepassword(void* lpObj, int trustedcertindex);
int securepdf_pdfverify_settrustedcertstorepassword(void* lpObj, int trustedcertindex, const char* lpszTrustedCertStorePassword);

int securepdf_pdfverify_gettrustedcertstoretype(void* lpObj, int trustedcertindex);
int securepdf_pdfverify_settrustedcertstoretype(void* lpObj, int trustedcertindex, int iTrustedCertStoreType);

char* securepdf_pdfverify_gettrustedcertsubjectaltnames(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertthumbprintmd5(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertthumbprintsha1(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertthumbprintsha256(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertusage(void* lpObj, int trustedcertindex);

int securepdf_pdfverify_gettrustedcertusageflags(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertversion(void* lpObj, int trustedcertindex);

char* securepdf_pdfverify_gettrustedcertsubject(void* lpObj, int trustedcertindex);
int securepdf_pdfverify_settrustedcertsubject(void* lpObj, int trustedcertindex, const char* lpszTrustedCertSubject);

int securepdf_pdfverify_gettrustedcertencoded(void* lpObj, int trustedcertindex, char** lpTrustedCertEncoded, int* lenTrustedCertEncoded);
int securepdf_pdfverify_settrustedcertencoded(void* lpObj, int trustedcertindex, const char* lpTrustedCertEncoded, int lenTrustedCertEncoded);

int GetTrustedCertCount();
int SetTrustedCertCount(int iTrustedCertCount);

QString GetTrustedCertEffectiveDate(int iTrustedCertIndex);

QString GetTrustedCertExpirationDate(int iTrustedCertIndex);

QString GetTrustedCertExtendedKeyUsage(int iTrustedCertIndex);

QString GetTrustedCertFingerprint(int iTrustedCertIndex);

QString GetTrustedCertFingerprintSHA1(int iTrustedCertIndex);

QString GetTrustedCertFingerprintSHA256(int iTrustedCertIndex);

QString GetTrustedCertIssuer(int iTrustedCertIndex);

QString GetTrustedCertPrivateKey(int iTrustedCertIndex);

bool GetTrustedCertPrivateKeyAvailable(int iTrustedCertIndex);

QString GetTrustedCertPrivateKeyContainer(int iTrustedCertIndex);

QString GetTrustedCertPublicKey(int iTrustedCertIndex);

QString GetTrustedCertPublicKeyAlgorithm(int iTrustedCertIndex);

int GetTrustedCertPublicKeyLength(int iTrustedCertIndex);

QString GetTrustedCertSerialNumber(int iTrustedCertIndex);

QString GetTrustedCertSignatureAlgorithm(int iTrustedCertIndex);

QByteArray GetTrustedCertStore(int iTrustedCertIndex);
int SetTrustedCertStore(int iTrustedCertIndex, QByteArray qbaTrustedCertStore);

QString GetTrustedCertStorePassword(int iTrustedCertIndex);
int SetTrustedCertStorePassword(int iTrustedCertIndex, QString qsTrustedCertStorePassword);

int GetTrustedCertStoreType(int iTrustedCertIndex);
int SetTrustedCertStoreType(int iTrustedCertIndex, int iTrustedCertStoreType);

QString GetTrustedCertSubjectAltNames(int iTrustedCertIndex);

QString GetTrustedCertThumbprintMD5(int iTrustedCertIndex);

QString GetTrustedCertThumbprintSHA1(int iTrustedCertIndex);

QString GetTrustedCertThumbprintSHA256(int iTrustedCertIndex);

QString GetTrustedCertUsage(int iTrustedCertIndex);

int GetTrustedCertUsageFlags(int iTrustedCertIndex);

QString GetTrustedCertVersion(int iTrustedCertIndex);

QString GetTrustedCertSubject(int iTrustedCertIndex);
int SetTrustedCertSubject(int iTrustedCertIndex, QString qsTrustedCertSubject);

QByteArray GetTrustedCertEncoded(int iTrustedCertIndex);
int SetTrustedCertEncoded(int iTrustedCertIndex, QByteArray qbaTrustedCertEncoded);

Remarks

This property is used to supply a list of trusted certificates to the class that might be needed for chain validation. For instance, root CA certificates may be absent from the standard system locations (or there may be no standard system locations) and therefore should be supplied to the class manually.

The purpose of this certificate properties is largely the same as that of the Windows Trusted Root Certification Authorities system store.

Use this property with extreme care as it directly affects chain verifiability; a wrong certificate added to the list of trusted certificates may result in bad chains being accepted and forfeited signatures being recognized as genuine. Only add certificates that originate from parties that are known and trusted.

This property is not available at design time.

Data Type

SecurePDFCertificate

TrustedLists Property (PDFVerify Class)

A list of known Trusted Lists for chain validation.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetTrustedLists();
int SetTrustedLists(const char* lpszTrustedLists);

Unicode (Windows)
LPWSTR GetTrustedLists();
INT SetTrustedLists(LPCWSTR lpszTrustedLists);

char* securepdf_pdfverify_gettrustedlists(void* lpObj);
int securepdf_pdfverify_settrustedlists(void* lpObj, const char* lpszTrustedLists);

QString GetTrustedLists();
int SetTrustedLists(QString qsTrustedLists);

Default Value

"%EUTL%"

Remarks

This property is used to supply a semicolon-separated list of URLs or paths of known Trusted Lists to the class for chain validation.

A Trusted List is an XML document that contains a government-issued list of CAs that have passed regulated compliance checks. When validating the chain, the class will consult the Trusted List to establish certificate trust, ensuring that the CA is legitimate and entitled to issue certificates of the kind being checked.

The default value is the special %EUTL% macro, which, if applicable, instructs the class to check the root certificate against up-to-date versions of the primary EU Trusted Lists from the EU LOTL. Custom values can be appended: component.TrustedLists = "%EUTL%;http://my.company/tsl;c:\tsls\mytsl.xml"; Note: The class will cache all Trusted Lists it downloads and uses during chain validation. This cache is shared between class instances within the same process. If this property contains a URL that is also present in the cache, the class will retrieve the cached data and reuse them in the current validation. If the data are invalid, the class will download a fresh Trusted List and add it to the cache.

Data Type

String

TrustSources Property (PDFVerify Class)

The trust sources to use during chain validation.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetTrustSources();
int SetTrustSources(int iTrustSources);

Unicode (Windows)
INT GetTrustSources();
INT SetTrustSources(INT iTrustSources);

TS_MANUAL(0), 
TS_LOCAL(1), 
TS_TRUSTED_LISTS(2), 
TS_LOCAL_AND_TRUSTED_LISTS(3)

int securepdf_pdfverify_gettrustsources(void* lpObj);
int securepdf_pdfverify_settrustsources(void* lpObj, int iTrustSources);

int GetTrustSources();
int SetTrustSources(int iTrustSources);

Default Value

3

Remarks

This property is used to specify the sources the class will use to establish certificate trust during chain validation.

Establishing trust for a particular certificate, when either signing or verifying, involves building a chain up to a valid trust anchor. This trust anchor is a root certificate that typically resides on the local system. If the certificate does not eventually chain up to a valid trust anchor, the chain is considered untrusted and therefore invalid.

Possible values are:

Data Type

Integer

ValidationFlags Property (PDFVerify Class)

Additional chain validation settings.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetValidationFlags();
int SetValidationFlags(int iValidationFlags);

Unicode (Windows)
INT GetValidationFlags();
INT SetValidationFlags(INT iValidationFlags);

int securepdf_pdfverify_getvalidationflags(void* lpObj);
int securepdf_pdfverify_setvalidationflags(void* lpObj, int iValidationFlags);

int GetValidationFlags();
int SetValidationFlags(int iValidationFlags);

Default Value

0

Remarks

This property is used to specify additional settings that affect the overall flow of the chain validation.

Its value should be provided as a bitmask of the following flags:

Data Type

Integer

ValidationPolicy Property (PDFVerify Class)

The level at which to perform chain validation.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetValidationPolicy();
int SetValidationPolicy(int iValidationPolicy);

Unicode (Windows)
INT GetValidationPolicy();
INT SetValidationPolicy(INT iValidationPolicy);

VP_NONE(0), 
VP_FULL(1), 
VP_FULL_NO_TRUST(2), 
VP_FULL_NO_REVOCATION(3), 
VP_BEST_EFFORT(4)

int securepdf_pdfverify_getvalidationpolicy(void* lpObj);
int securepdf_pdfverify_setvalidationpolicy(void* lpObj, int iValidationPolicy);

int GetValidationPolicy();
int SetValidationPolicy(int iValidationPolicy);

Default Value

1

Remarks

This property is used to specify the overall validation policy the class will follow.

Possible values are:

Validation Policy Heuristics

Creating a new signature:

• For a basic signature with or without a timestamp, chain validation is not required, so it is recommended to use vpNone. This policy may also be used in test environments or on offline systems.
• For an LTV signature, use vpFull or vpFullNoTrust depending on whether trust checks are necessary in the current environment. If the signature is being created in an environment that does not match the prospective validation environment, consider vpFullNoTrust to validate the chain properly and fully without expecting good trust.

Updating or extending an existing signature:

• When updating a basic signature to LTV, similarly use vpFull or vpFullNoTrust as above.
• When extending an LTV signature, similarly use vpFull or vpFullNoTrust as above.

Validating an existing signature:

• For basic signature validation, use vpFullNoRevocation if trust checks, but not revocation checks, are necessary in the current environment. This policy may also be used on offline systems if the trust anchor is already available to the class.
• For archival validation, use vpFull to validate the chain properly and fully. This policy expects the trust anchor and all the revocation material to be available.

Data Type

Integer

ValidationTime Property (PDFVerify Class)

The time point at which the signature should be validated.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetValidationTime();
int SetValidationTime(const char* lpszValidationTime);

Unicode (Windows)
LPWSTR GetValidationTime();
INT SetValidationTime(LPCWSTR lpszValidationTime);

char* securepdf_pdfverify_getvalidationtime(void* lpObj);
int securepdf_pdfverify_setvalidationtime(void* lpObj, const char* lpszValidationTime);

QString GetValidationTime();
int SetValidationTime(QString qsValidationTime);

Default Value

""

Remarks

This property is used to specify the moment in time at which the signature validity should be established. The time should be provided in UTC in yyyyMMddHHmmssZ format.

Leave this property empty to stick to the default time point. The class will then prioritize:

• The signature creation time if the signature contains a signature timestamp (ValidatedSigningTime), or
• The local time included in the signature by the signer (ClaimedSigningTime).

Data Type

String

Close Method (PDFVerify Class)

Closes an opened PDF document.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Close();

Unicode (Windows)
INT Close();

int securepdf_pdfverify_close(void* lpObj);

int Close();

Remarks

This method is used to close the previously opened document specified in InputFile, InputData, or SetInputStream. It should always be preceded by a call to the Open method.

Example: component.InputFile = "input.pdf"; component.Open(); // Some operation component.Close();

If any changes are made to the document, they will be saved automatically to OutputFile, OutputData, or the stream set in SetOutputStream when this method is called. To configure this saving behavior, set the SaveChanges configuration setting.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Config Method (PDFVerify Class)

Sets or retrieves a configuration setting.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* Config(const char* lpszConfigurationString);

Unicode (Windows)
LPWSTR Config(LPCWSTR lpszConfigurationString);

char* securepdf_pdfverify_config(void* lpObj, const char* lpszConfigurationString);

QString Config(const QString& qsConfigurationString);

Remarks

Config is a generic method available in every class. It is used to set and retrieve configuration settings for the class.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the class, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

Encrypted Method (PDFVerify Class)

Checks whether a PDF document is encrypted.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
bool Encrypted();

Unicode (Windows)
bool Encrypted();

bool securepdf_pdfverify_encrypted(void* lpObj);

bool Encrypted();

Remarks

This method is used to determine whether or not the document specified in InputFile, InputData, or SetInputStream is encrypted. It will return false if the document is pseudo-encrypted with an empty password.

Example: component.InputFile = "input.pdf"; if (component.Encrypted()) { // Set Password or DecryptionCert } component.Open(); // Some operation component.Close(); Note: If the document is not already opened, this method will open it, perform the operation, then close it.

Error Handling (C++)

This method returns a Boolean value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

GetPageProperty Method (PDFVerify Class)

Retrieves the value of a page property.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPageProperty(int iPage, const char* lpszPageProperty);

Unicode (Windows)
LPWSTR GetPageProperty(INT iPage, LPCWSTR lpszPageProperty);

char* securepdf_pdfverify_getpageproperty(void* lpObj, int iPage, const char* lpszPageProperty);

QString GetPageProperty(int iPage, const QString& qsPageProperty);

Remarks

This method is used to read general information about the pages of the document specified in InputFile, InputData, or SetInputStream, such as their dimensions and content positioning details.

The Page parameter specifies the page to read information about (with a valid range from 1 to PageCount), and the PageProperty parameter specifies the page property to read. The latter can take one of the following values:

Note: Each page property is only populated once the document has been loaded, which is reported by the DocumentInfo event.

Example: int pageCount = 0; component.OnDocumentInfo += (s, e) => { pageCount = e.PageCount; }; component.InputFile = "input.pdf"; component.Open(); for (int i = 1; i <= pageCount; i++) component.GetPageProperty(i, "Height"); component.Close(); The page properties can be used to adjust the position of the signature widget based on the page dimensions. For example: int x = int.Parse(pdfsign.GetPageProperty(1, "Width")) - 100; int y = int.Parse(pdfsign.GetPageProperty(1, "Height")) - 100; pdfsign.SetWidgetProperty("OffsetX", x.ToString()); pdfsign.SetWidgetProperty("OffsetY", y.ToString()); Note: If the document is not already opened, this method will open it, perform the operation, then close it.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

GetSignedVersion Method (PDFVerify Class)

Returns the part of a signed PDF document that is covered by the signature.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetSignedVersion(int iSignatureIndex);

Unicode (Windows)
INT GetSignedVersion(INT iSignatureIndex);

int securepdf_pdfverify_getsignedversion(void* lpObj, int iSignatureIndex);

int GetSignedVersion(int iSignatureIndex);

Remarks

This method is used to retrieve the revision of the document specified in InputFile, InputData, or SetInputStream that is covered by the signature specified by SignatureIndex. The extracted revision will be saved to OutputFile, OutputData, or the stream set in SetOutputStream.

The SignatureIndex parameter is the index of the signature of interest in the Signatures properties.

Example: pdfverify.InputFile = "signed.pdf"; pdfverify.OutputFile = "revision0.pdf"; pdfverify.GetSignedVersion(0); PDF documents often use an incremental update approach, with any changes being appended to the document without altering the existing revision. This may lead to situations where a signature only covers part of the document (one of the past revisions), but not subsequent changes. This method provides a means to extract the revision that is actually certified by the signature.

It is recommended to use this method when validating signatures to make sure the signature covers the byte range it is expected to cover.

An alternative to this method is to check the CoverageEndsAt field of the signature object and match it to the document length.

Note: If the document is not already opened, this method will open it, perform the operation, then close it.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Interrupt Method (PDFVerify Class)

Interrupts the current action.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Interrupt();

Unicode (Windows)
INT Interrupt();

int securepdf_pdfverify_interrupt(void* lpObj);

int Interrupt();

Remarks

This method interrupts the current action. It can be used, for example, within the ChainCert event to abort the chain validation procedure.

If there is no action in progress, this method simply returns, doing nothing.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Open Method (PDFVerify Class)

Opens a PDF document for processing.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Open();

Unicode (Windows)
INT Open();

int securepdf_pdfverify_open(void* lpObj);

int Open();

Remarks

This method is used to open the document specified in InputFile, InputData, or SetInputStream before performing some operation on it, such as verifying or removing signatures. When finished, call Close to complete or discard the operation.

It is recommended to use this method (alongside Close) when performing multiple operations on the document at once.

Note: This method will populate the Attachments, DocumentCerts, and Signatures collections with any corresponding objects found in the document.

Automatic Decryption Functionality

Once the correct decryption material is supplied, the class will then attempt to decrypt the document automatically within this method. When this occurs, the decrypted content is kept in memory so that the document's encrypted status is preserved when it is saved later. Use the Decrypt method to save a decrypted copy of the document instead.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Reset Method (PDFVerify Class)

Resets the class.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Reset();

Unicode (Windows)
INT Reset();

int securepdf_pdfverify_reset(void* lpObj);

int Reset();

Remarks

This method is used to reset the class's properties and configuration settings to their default values.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

SaveAttachment Method (PDFVerify Class)

Saves a PDF attachment to a file.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SaveAttachment(int iIndex, const char* lpszFileName);

Unicode (Windows)
INT SaveAttachment(INT iIndex, LPCWSTR lpszFileName);

int securepdf_pdfverify_saveattachment(void* lpObj, int iIndex, const char* lpszFileName);

int SaveAttachment(int iIndex, const QString& qsFileName);

Remarks

This method is used to retrieve the contents of an attachment from the document specified in InputFile, InputData, or SetInputStream and save it to the file specified by FileName. It does not modify the existence of the Attachments properties's contents.

The Index parameter is the index of the attachment in the Attachments properties to be saved.

The FileName parameter specifies the filename that the attachment will be saved to.

Example: component.InputFile = "input_with_attachment.pdf"; component.Open(); component.SaveAttachment(0, "a.dat"); component.Close(); Example (saving to a stream): component.InputFile = "input_with_attachment.pdf"; component.Attachments[0].OutputStream = myStream; component.SaveAttachment(0, null); // null means use the OutputStream field if it's set Note: If the document is not already opened, this method will open it, perform the operation, then close it.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

SetInputStream Method (PDFVerify Class)

Sets the stream containing the PDF document to process.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SetInputStream(SecurePDFStream* sInputStream);

Unicode (Windows)
INT SetInputStream(SecurePDFStream* sInputStream);

int securepdf_pdfverify_setinputstream(void* lpObj, SecurePDFStream* sInputStream);

int SetInputStream(SecurePDFStream* sInputStream);

Remarks

This method is used to set the stream from which the class will read the PDF document to be processed. If an input stream is set before the class attempts to perform operations on the document, the class will read the data from the input stream instead of from the InputFile or InputData properties.

Note: It may be useful to additionally set the CloseInputStreamAfterProcessing configuration setting to true when using input streams.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

SetOutputStream Method (PDFVerify Class)

Sets the stream to write the processed document to.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SetOutputStream(SecurePDFStream* sOutputStream);

Unicode (Windows)
INT SetOutputStream(SecurePDFStream* sOutputStream);

int securepdf_pdfverify_setoutputstream(void* lpObj, SecurePDFStream* sOutputStream);

int SetOutputStream(SecurePDFStream* sOutputStream);

Remarks

This method is used to set the stream to which the class will write the resulting PDF document. If an output stream is set before the class attempts to perform operations on the document, the class will write the data to the output stream instead of writing to OutputFile or populating OutputData.

Note: It may be useful to additionally set the CloseOutputStreamAfterProcessing configuration setting to true when using output streams.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Signed Method (PDFVerify Class)

Checks whether a PDF document is signed.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
bool Signed();

Unicode (Windows)
bool Signed();

bool securepdf_pdfverify_signed(void* lpObj);

bool Signed();

Remarks

This method is used to determine whether or not the document specified in InputFile, InputData, or SetInputStream is signed. It will return false if the document contains only empty signature fields.

Example: pdfverify.InputFile = "input.pdf"; if (pdfverify.Signed()) { // Configure validation-related properties as desired pdfverify.Verify(); } Note: If the document is not already opened, this method will open it, perform the operation, then close it.

Error Handling (C++)

This method returns a Boolean value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

Unsign Method (PDFVerify Class)

Removes a signature from a PDF document.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Unsign(int iSignatureIndex, int iUnsignKind);

Unicode (Windows)
INT Unsign(INT iSignatureIndex, INT iUnsignKind);

int securepdf_pdfverify_unsign(void* lpObj, int iSignatureIndex, int iUnsignKind);

int Unsign(int iSignatureIndex, int iUnsignKind);

Remarks

This method is used to remove an existing signature specified by SignatureIndex from the document specified in InputFile, InputData, or SetInputStream. The document with the removed signature will be saved to OutputFile, OutputData, or the stream set in SetOutputStream.

The SignatureIndex parameter is the index of the signature in the Signatures properties to be removed.

The UnsignKind parameter specifies the kind of unsign to perform. Possible values are:

Example: pdfverify.InputFile = "signed.pdf"; pdfverify.OutputFile = "unsigned.pdf"; pdfverify.Open(); int idx = pdfverify.Signatures.Count - 1; pdfverify.Unsign(idx, 0); // uskFull pdfverify.Close(); Note that unsigning is different from GetSignedVersion. The latter returns the revision of the document including the mentioned signature (thus removing anything after that signature was created). Unsign removes the signature completely by carving it out of the document.

Note: SignatureIndex set to -1 removes all signatures in the document.

Note: If the document is not already opened, this method will open it, perform the operation, then close it.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Verify Method (PDFVerify Class)

Verifies a signed PDF document.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Verify();

Unicode (Windows)
INT Verify();

int securepdf_pdfverify_verify(void* lpObj);

int Verify();

Remarks

This method is used to validate all signatures in the document specified in InputFile, InputData, or SetInputStream.

This method walks through the signed document and reports every signature via the SignatureInfo event. Subscribe to the event to be notified about the signatures and adjust validation settings on the fly.

Upon completion of this method, the signature details will be published in the Signatures property.

Example: pdfverify.InputFile = "signed.pdf"; pdfverify.Verify(); PDFSignature signature = pdfverify.Signatures[0]; if (signature.ValidationResult == SignatureValidationResults.svrValid) Console.WriteLine("Signature is good"); if (signature.ChainValidationResult == ChainValidationResults.cvrValid) Console.WriteLine("Chain is good"); This method only validates the signatures and does not check their coverage. It is a good idea to use mechanisms such as GetSignedVersion or CoverageEndsAt to ensure that the signature covers the expected document revision.

To control individual signature validation, subscribe to the SignatureInfo event and set the ValidateSignature and ValidateChain parameters accordingly. The results are reported via the SignatureProcessed event.

Use the following properties to adjust chain validation parameters:

• BlockedCerts
• KnownCerts
• OfflineMode
• RevocationCheck
• TrustedCerts
• TrustedLists
• TrustSources
• ValidationFlags
• ValidationPolicy
• ValidationTime

Note: If the document is not already opened, this method will open it, perform the operation, then close it.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ChainCert Event (PDFVerify Class)

Fired when the class encounters a chain certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireChainCert(PDFVerifyChainCertEventParams *e);

typedef struct {
  const char *CertEncoded;
  int lenCertEncoded;
  const char *CertSubject;
  const char *CertIssuer;
  const char *ValidationTime;
  int ValidationResult;
  int ValidationDetails;
  int reserved;
} PDFVerifyChainCertEventParams;


Unicode (Windows)
virtual INT FireChainCert(PDFVerifyChainCertEventParams *e);

typedef struct {
  LPCSTR CertEncoded;
  INT lenCertEncoded;
  LPCWSTR CertSubject;
  LPCWSTR CertIssuer;
  LPCWSTR ValidationTime;
  INT ValidationResult;
  INT ValidationDetails;
  INT reserved;
} PDFVerifyChainCertEventParams;

#define EID_PDFVERIFY_CHAINCERT 1

virtual INT SECUREPDF_CALL FireChainCert(LPSTR &lpCertEncoded, INT &lenCertEncoded, LPSTR &lpszCertSubject, LPSTR &lpszCertIssuer, LPSTR &lpszValidationTime, INT &iValidationResult, INT &iValidationDetails);

class PDFVerifyChainCertEventParams {
public:
  const QByteArray &CertEncoded();

  const QString &CertSubject();

  const QString &CertIssuer();

  const QString &ValidationTime();

  int ValidationResult();
  void SetValidationResult(int iValidationResult);

  int ValidationDetails();
  void SetValidationDetails(int iValidationDetails);

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void ChainCert(PDFVerifyChainCertEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireChainCert(PDFVerifyChainCertEventParams *e) {...}

Remarks

This event is fired once for each certificate encountered during chain validation to report that it is about to be processed. The class will try to retrieve all required chain certificates automatically.

The CertEncoded parameter specifies the PEM (Base64-encoded) public certificate.

The CertSubject and CertIssuer parameters specify the distinguished names of the certificate owner and issuer respectively.

The ValidationTime parameter specifies the time point (in UTC) at which the certificate validity was established.

The ValidationResult parameter reports the outcome of the individual certificate validation and can be one of the following values:

In the case of a failure, the ValidationDetails parameter provides more details on its reasons. Its value is a bitmask of the following flags:

Overridable Chain Validation

For example, set ValidationResult to cvrValid and ValidationDetails to 0 in order to:

• Ignore CA or TLS key usage requirements
• Ignore the AuthorityKeyId extension in certificate-issuing CAs (helps with incorrectly renewed certificates)
• Ignore the Basic Constraints or Name Constraints extensions of CA certificates
• Tolerate some weaker algorithms
• Implicitly trust self-signed certificates
• Skip validity period checks for trusted certificates (helps with older devices that have expired root certificates)
• Ignore chain loops (helps with buggy CAs that include subchains that sign themselves)

Note: The user code is ultimately responsible for certificate validity decisions made via these two parameters. If their values are modified within this event, the resulting chain validation procedure may deviate from the standard.

DocumentInfo Event (PDFVerify Class)

Fired when the document has been loaded into memory.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireDocumentInfo(PDFVerifyDocumentInfoEventParams *e);

typedef struct {
  int PageCount;
  int SignatureCount;
  int reserved;
} PDFVerifyDocumentInfoEventParams;


Unicode (Windows)
virtual INT FireDocumentInfo(PDFVerifyDocumentInfoEventParams *e);

typedef struct {
  INT PageCount;
  INT SignatureCount;
  INT reserved;
} PDFVerifyDocumentInfoEventParams;

#define EID_PDFVERIFY_DOCUMENTINFO 2

virtual INT SECUREPDF_CALL FireDocumentInfo(INT &iPageCount, INT &iSignatureCount);

class PDFVerifyDocumentInfoEventParams {
public:
  int PageCount();

  int SignatureCount();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void DocumentInfo(PDFVerifyDocumentInfoEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireDocumentInfo(PDFVerifyDocumentInfoEventParams *e) {...}

Remarks

This event is fired once per document processing routine to report that the document has been processed and loaded into memory.

The handler for this event is a good place to check the document structure and access document-related information such as page number and document file details. These may be useful when preparing the signature. For example, the GetPageProperty method can be used to find the optimal position for the signature widget.

The PageCount parameter reports the number of pages in the document.

The SignatureCount parameter reports the number of signatures in the document.

This event is fired when the Open method is called, but only after Password or RecipientInfo is fired (if applicable) and the document has been decrypted.

Error Event (PDFVerify Class)

Fired when information is available about errors during data delivery.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireError(PDFVerifyErrorEventParams *e);

typedef struct {
  int ErrorCode;
  const char *Description;
  int reserved;
} PDFVerifyErrorEventParams;


Unicode (Windows)
virtual INT FireError(PDFVerifyErrorEventParams *e);

typedef struct {
  INT ErrorCode;
  LPCWSTR Description;
  INT reserved;
} PDFVerifyErrorEventParams;

#define EID_PDFVERIFY_ERROR 3

virtual INT SECUREPDF_CALL FireError(INT &iErrorCode, LPSTR &lpszDescription);

class PDFVerifyErrorEventParams {
public:
  int ErrorCode();

  const QString &Description();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Error(PDFVerifyErrorEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireError(PDFVerifyErrorEventParams *e) {...}

Remarks

The Error event is fired in case of exceptional conditions during message processing. Normally the class fails with an error.

The ErrorCode parameter contains an error code, and the Description parameter contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

Log Event (PDFVerify Class)

Fired once for each log message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireLog(PDFVerifyLogEventParams *e);

typedef struct {
  int LogLevel;
  const char *Message;
  const char *LogType;
  int reserved;
} PDFVerifyLogEventParams;


Unicode (Windows)
virtual INT FireLog(PDFVerifyLogEventParams *e);

typedef struct {
  INT LogLevel;
  LPCWSTR Message;
  LPCWSTR LogType;
  INT reserved;
} PDFVerifyLogEventParams;

#define EID_PDFVERIFY_LOG 4

virtual INT SECUREPDF_CALL FireLog(INT &iLogLevel, LPSTR &lpszMessage, LPSTR &lpszLogType);

class PDFVerifyLogEventParams {
public:
  int LogLevel();

  const QString &Message();

  const QString &LogType();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Log(PDFVerifyLogEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireLog(PDFVerifyLogEventParams *e) {...}

Remarks

This event is fired once for each log message generated by the class. The verbosity is controlled by the LogLevel configuration setting.

The LogLevel parameter indicates the detail level of the message. Possible values are:

The Message parameter is the log message.

The LogType parameter identifies the type of log entry. Possible values are:

• CertValidator
• Font
• HTTP
• PDFInvalidSignature
• PDFRevocationInfo
• Timestamp
• TSL

Password Event (PDFVerify Class)

Fired when the class detects that the PDF document is encrypted with a password.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FirePassword(PDFVerifyPasswordEventParams *e);

typedef struct {
  int Available;
  int Cancel;
  int reserved;
} PDFVerifyPasswordEventParams;


Unicode (Windows)
virtual INT FirePassword(PDFVerifyPasswordEventParams *e);

typedef struct {
  BOOL Available;
  BOOL Cancel;
  INT reserved;
} PDFVerifyPasswordEventParams;

#define EID_PDFVERIFY_PASSWORD 5

virtual INT SECUREPDF_CALL FirePassword(BOOL &bAvailable, BOOL &bCancel);

class PDFVerifyPasswordEventParams {
public:
  bool Available();

  bool Cancel();
  void SetCancel(bool bCancel);

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Password(PDFVerifyPasswordEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FirePassword(PDFVerifyPasswordEventParams *e) {...}

Remarks

This event is fired during document processing to report that the document is encrypted with a password. It may be used to supply the correct decryption password to the Password property.

The Available parameter indicates whether the decryption password is already available to the class or still needs to be set. If this parameter is set to false, the correct password must be provided for the decryption attempt to succeed.

The Cancel parameter determines whether the class will stop firing this event to request a password.

RecipientInfo Event (PDFVerify Class)

Fired for each recipient certificate of the encrypted PDF document.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireRecipientInfo(PDFVerifyRecipientInfoEventParams *e);

typedef struct {
  const char *Issuer;
  const char *SerialNumber;
  const char *SubjectKeyIdentifier;
  int Available;
  int Cancel;
  int reserved;
} PDFVerifyRecipientInfoEventParams;


Unicode (Windows)
virtual INT FireRecipientInfo(PDFVerifyRecipientInfoEventParams *e);

typedef struct {
  LPCWSTR Issuer;
  LPCWSTR SerialNumber;
  LPCWSTR SubjectKeyIdentifier;
  BOOL Available;
  BOOL Cancel;
  INT reserved;
} PDFVerifyRecipientInfoEventParams;

#define EID_PDFVERIFY_RECIPIENTINFO 6

virtual INT SECUREPDF_CALL FireRecipientInfo(LPSTR &lpszIssuer, LPSTR &lpszSerialNumber, LPSTR &lpszSubjectKeyIdentifier, BOOL &bAvailable, BOOL &bCancel);

class PDFVerifyRecipientInfoEventParams {
public:
  const QString &Issuer();

  const QString &SerialNumber();

  const QString &SubjectKeyIdentifier();

  bool Available();

  bool Cancel();
  void SetCancel(bool bCancel);

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void RecipientInfo(PDFVerifyRecipientInfoEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireRecipientInfo(PDFVerifyRecipientInfoEventParams *e) {...}

Remarks

This event is fired during document processing for each recipient certificate that the document has been encrypted for (if applicable). It may be used to identify the certificate(s) to load and supply to the DecryptionCert property.

The Issuer parameter specifies the subject of the issuer certificate.

The SerialNumber parameter specifies the serial number of the encryption certificate.

The SubjectKeyIdentifier parameter specifies the X.509 subjectKeyIdentifier extension value of the encryption certificate, encoded as a hex string.

The Available parameter indicates whether the decryption certificate is already available to the class or still needs to be set. If this parameter is set to false, the correct certificate must be provided for the decryption attempt to succeed.

The Cancel parameter determines whether the class will stop firing this event to request a certificate.

Note: The document may be encrypted with more than one certificate (or have "more than one recipient"), in which case each certificate will cause its own invocation of this event.

SignatureInfo Event (PDFVerify Class)

Fired when the class finds a signature in the document.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSignatureInfo(PDFVerifySignatureInfoEventParams *e);

typedef struct {
  int SignatureIndex;
  int ValidateSignature;
  int ValidateChain;
  int reserved;
} PDFVerifySignatureInfoEventParams;


Unicode (Windows)
virtual INT FireSignatureInfo(PDFVerifySignatureInfoEventParams *e);

typedef struct {
  INT SignatureIndex;
  BOOL ValidateSignature;
  BOOL ValidateChain;
  INT reserved;
} PDFVerifySignatureInfoEventParams;

#define EID_PDFVERIFY_SIGNATUREINFO 7

virtual INT SECUREPDF_CALL FireSignatureInfo(INT &iSignatureIndex, BOOL &bValidateSignature, BOOL &bValidateChain);

class PDFVerifySignatureInfoEventParams {
public:
  int SignatureIndex();

  bool ValidateSignature();
  void SetValidateSignature(bool bValidateSignature);

  bool ValidateChain();
  void SetValidateChain(bool bValidateChain);

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SignatureInfo(PDFVerifySignatureInfoEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireSignatureInfo(PDFVerifySignatureInfoEventParams *e) {...}

Remarks

This event is fired once for each signature found in the document to report that the signature specified by SignatureIndex is about to be validated.

The SignatureIndex parameter is the index of the signature in the Signatures properties.

Signature validation consists of two independent stages: cryptographic signature validation and chain validation. The ValidateSignature and ValidateChain parameters determine whether each stage should be included in the validation. They can be overridden to modify the validation policy on a per-signature basis, allowing signatures to be verified individually instead of all at once (via Verify). To skip validation entirely, set both parameters to false.

Use the following properties to adjust chain validation parameters:

• BlockedCerts
• KnownCerts
• OfflineMode
• RevocationCheck
• TrustedCerts
• TrustedLists
• TrustSources
• ValidationFlags
• ValidationPolicy
• ValidationTime

SignatureProcessed Event (PDFVerify Class)

Fired after a signature has been processed.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSignatureProcessed(PDFVerifySignatureProcessedEventParams *e);

typedef struct {
  int SignatureIndex;
  int SignatureValidationResult;
  int ChainValidationResult;
  int ChainValidationDetails;
  int reserved;
} PDFVerifySignatureProcessedEventParams;


Unicode (Windows)
virtual INT FireSignatureProcessed(PDFVerifySignatureProcessedEventParams *e);

typedef struct {
  INT SignatureIndex;
  INT SignatureValidationResult;
  INT ChainValidationResult;
  INT ChainValidationDetails;
  INT reserved;
} PDFVerifySignatureProcessedEventParams;

#define EID_PDFVERIFY_SIGNATUREPROCESSED 8

virtual INT SECUREPDF_CALL FireSignatureProcessed(INT &iSignatureIndex, INT &iSignatureValidationResult, INT &iChainValidationResult, INT &iChainValidationDetails);

class PDFVerifySignatureProcessedEventParams {
public:
  int SignatureIndex();

  int SignatureValidationResult();

  int ChainValidationResult();

  int ChainValidationDetails();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SignatureProcessed(PDFVerifySignatureProcessedEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireSignatureProcessed(PDFVerifySignatureProcessedEventParams *e) {...}

Remarks

This event is fired once for each signature found in the document to report that the signature specified by SignatureIndex has completed validation. It is fired after SignatureInfo if that event's ValidateSignature parameter is set to true.

The SignatureIndex parameter is the index of the signature in the Signatures properties.

Signature validation consists of two independent stages: cryptographic signature validation and chain validation. Separate validation results are reported for each in the SignatureValidationResult and ChainValidationResult parameters.

The former reports the validity of the signature and can be one of the following values:

The latter reports the validity of the chain and can be one of the following values:

In the case of a failure, the ChainValidationDetails parameter provides more details on its reasons. Its value is a bitmask of the following flags:

Note: SignatureValidationResult, ChainValidationResult, and ChainValidationDetails are also available as fields in the PDFSignature type.

SSLServerAuthentication Event (PDFVerify Class)

Fired after the server presents its certificate to the client.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSSLServerAuthentication(PDFVerifySSLServerAuthenticationEventParams *e);

typedef struct {
  const char *CertEncoded;
  int lenCertEncoded;
  const char *CertSubject;
  const char *CertIssuer;
  const char *Status;
  int Accept;
  int reserved;
} PDFVerifySSLServerAuthenticationEventParams;


Unicode (Windows)
virtual INT FireSSLServerAuthentication(PDFVerifySSLServerAuthenticationEventParams *e);

typedef struct {
  LPCSTR CertEncoded;
  INT lenCertEncoded;
  LPCWSTR CertSubject;
  LPCWSTR CertIssuer;
  LPCWSTR Status;
  BOOL Accept;
  INT reserved;
} PDFVerifySSLServerAuthenticationEventParams;

#define EID_PDFVERIFY_SSLSERVERAUTHENTICATION 9

virtual INT SECUREPDF_CALL FireSSLServerAuthentication(LPSTR &lpCertEncoded, INT &lenCertEncoded, LPSTR &lpszCertSubject, LPSTR &lpszCertIssuer, LPSTR &lpszStatus, BOOL &bAccept);

class PDFVerifySSLServerAuthenticationEventParams {
public:
  const QByteArray &CertEncoded();

  const QString &CertSubject();

  const QString &CertIssuer();

  const QString &Status();

  bool Accept();
  void SetAccept(bool bAccept);

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SSLServerAuthentication(PDFVerifySSLServerAuthenticationEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireSSLServerAuthentication(PDFVerifySSLServerAuthenticationEventParams *e) {...}

Remarks

This event is fired during timestamping or chain validation after the server presents its SSL/TLS certificate to the class. It only applies if the TSA, CRL, OCSP, or Trusted List endpoint operates over HTTPS.

During this event, the client can decide whether or not to continue with the connection process. The Accept parameter is a recommendation on whether to continue or close the connection. This is just a suggestion: application software must use its own logic to determine whether or not to continue.

When the Accept parameter is false, the Status parameter shows why the verification failed (otherwise, Status contains the string OK). If it is decided to continue, you can override and accept the certificate by setting the Accept parameter to true.

SSLStatus Event (PDFVerify Class)

Fired when secure connection progress messages are available.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSSLStatus(PDFVerifySSLStatusEventParams *e);

typedef struct {
  const char *Message;
  int reserved;
} PDFVerifySSLStatusEventParams;


Unicode (Windows)
virtual INT FireSSLStatus(PDFVerifySSLStatusEventParams *e);

typedef struct {
  LPCWSTR Message;
  INT reserved;
} PDFVerifySSLStatusEventParams;

#define EID_PDFVERIFY_SSLSTATUS 10

virtual INT SECUREPDF_CALL FireSSLStatus(LPSTR &lpszMessage);

class PDFVerifySSLStatusEventParams {
public:
  const QString &Message();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SSLStatus(PDFVerifySSLStatusEventParams *e);

// Or, subclass PDFVerify and override this emitter function.
virtual int FireSSLStatus(PDFVerifySSLStatusEventParams *e) {...}

Remarks

This event is fired during timestamping or chain validation for informational and logging purposes only. This event tracks the progress of the SSL/TLS connection. It only applies if the TSA, CRL, OCSP, or Trusted List endpoint operates over HTTPS.

Certificate Type

This is the digital certificate being used.

Syntax

SecurePDFCertificate (declared in securepdf.h)

Remarks

This type describes the current digital certificate. The certificate may be a public or private key. The fields are used to identify or select certificates.

Fields

Constructors

Certificate()

Certificate(const char* lpEncoded, int lenEncoded)

Certificate(int iStoreType, const char* lpStore, int lenStore, const char* lpszStorePassword, const char* lpszSubject)

Firewall Type

The firewall the component will connect through.

Syntax

SecurePDFFirewall (declared in securepdf.h)

Remarks

When connecting through a firewall, this type is used to specify different properties of the firewall, such as the firewall Host and the FirewallType.

Fields

Constructors

Firewall()

PDFAttachment Type

This describes the file being attached to the PDF document.

Syntax

SecurePDFPDFAttachment (declared in securepdf.h)

Remarks

This type contains information about the file that is being attached to the document.

Fields

Constructors

PDFAttachment()

PDFAttachment(const char* lpszFileName)

PDFAttachment(const char* lpszFileName, const char* lpszDescription)

PDFAttachment(const char* lpData, int lenData, const char* lpszName, const char* lpszDescription)

PDFSignature Type

A container for PDF signature details.

Syntax

SecurePDFPDFSignature (declared in securepdf.h)

Remarks

This type contains details about the signature. Use it to read information about the signature when processing it.

Fields

Constructors

PDFSignature()

Proxy Type

The proxy the component will connect to.

Syntax

SecurePDFProxy (declared in securepdf.h)

Remarks

When connecting through a proxy, this type is used to specify different properties of the proxy, such as the Server and the AuthScheme.

Fields

Constructors

Proxy()

Proxy(const char* lpszServer, int iPort)

Proxy(const char* lpszServer, int iPort, const char* lpszUser, const char* lpszPassword)

SecurePDFList Type

Syntax

SecurePDFList<T> (declared in securepdf.h)

Remarks

SecurePDFList is a generic class that is used to hold a collection of objects of type T, where T is one of the custom types supported by the PDFVerify class.

int GetCount() {}

int SetCount(int count) {}

T* Get(int index) {}

T* Set(int index, T* value) {}

SecurePDFStream Type

Syntax

SecurePDFStream (declared in securepdf.h)

Remarks

The PDFVerify class includes one or more API members that take a stream object as a parameter. To use such API members, create a concrete class that implements the SecurePDFStream interface and pass the PDFVerify class an instance of that concrete class.

When implementing the SecurePDFStream interface's properties and methods, they must behave as described below. If the concrete class's implementation does not behave as expected, undefined behavior may occur.

bool CanRead() { return true; }

bool CanSeek() { return true; }

bool CanWrite() { return true; }

int64 GetLength() = 0;

void Close() {}

int Flush() { return 0; }

int Read(void* buffer, int count) = 0;

int64 Seek(int64 offset, int seekOrigin) = 0;

int Write(const void* buffer, int count) = 0;

Config Settings (PDFVerify Class)

PDFVerify Config Settings

Base Config Settings

Trappable Errors (PDFVerify Class)

Error Handling (C++)

Call the GetLastErrorCode() method to obtain the last called method's result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. Known error codes are listed below. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.

PDFVerify Errors

PDF Errors

Parsing Errors

The class may also return one of the following error codes, which are inherited from other classes.

HTTP Errors

The class may also return one of the following error codes, which are inherited from other classes.

TCPClient Errors

SSL Errors

TCP/IP Errors