CertificateValidator Class

Properties   Methods   Events   Config Settings   Errors  

The CertificateValidator class provides fine-grained validation of X.509 certificates.

Syntax

CertificateValidator

Remarks

This is a powerful and configurable class which can be used to validate all kinds of certificates and their chains.

The purpose of CertificateValidator is to validate certificate chains according to the X.509 specification. It supports a variety of technologies, including CRL and OCSP services, and can provide a comprehensive output on the certificate cryptographic validity, chain integrity, and trust levels. CertificateValidator is used internally in many other SecureBlackbox components, such as PDFSigner, HTTPClient, and OfficeVerifier.

To validate a certificate, please tune up the component as following:

• Assign the certificate to be validated to the Certificate property.
• Set RevocationCheck in accordance with your revocation check preferences.
• Enable UseSystemCertificates property to trust certificates that are trusted by the operating system. Copy any certificates that are not available in the standard system locations to KnownCertificates and TrustedCertificates collections (see Note 1 below).
• Optionally, adjust TLSSettings and SocketSettings.
• Adjust ValidationMoment if you would like to check the certificate validity at a different moment in time. Leave it unchanged to validate the certificate at the current time moment.
• Call Validate or ValidateForSSL method to initiate chain validation.

Depending on the complexity of the chain and the configuration of the component, the validation routine may take certain amount of time. The validator reports chain validation progress using a selection of events, such as BeforeCertificateProcessing, AfterCertificateProcessing, and CRLDownloaded events. It may also ask you for missing objects using CRLNeeded or CACertificateNeeded events. In each such event handler you can access the currently validated certificate via the CurrentCertificate property, and the interim validity figures via the InterimValidationResult and InterimValidationDetails property.

The return of the Validate (or similar) method indicates the completion of the validation procedure. The outcome of the chain validation is represented with the two parameters:

• ChainValidationResult reports the general validation outcome: valid, valid-but-untrusted, invalid, and unknown. As a rule, only the valid result can be taken as a good reason to consider the chain valid.
• ChainValidationDetails provides insights into the factors that caused the validation to fail.

Note 1: On Windows, CertificateValidator can use CA and ROOT system stores to look for any missing CA certificates and trust anchors. No similar functionality is currently available for other platforms, so in most cases you must provide your own list of trusted and CA certificates via TrustedCertificates and KnownCertificates collections to have your chains validate fully in Linux and macOS projects.

Note 2: The OfflineMode property is a handy way to check the completeness of your revocation/validation information. When the offline mode is on, CertificateValidator won't go online for any missing certificates, CRLs, and OCSP responses. Paired with a switched-off UseSystemCertificates property, it allows to make sure that any content provided via KnownCertificates, KnownCRLs, and KnownOCSPs represents the complete set of validation information required to validate the chain.

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.

BlockedCertCount Property (CertificateValidator Class)

The number of records in the BlockedCert arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetBlockedCertCount();
int SetBlockedCertCount(int iBlockedCertCount);

Unicode (Windows)
INT GetBlockedCertCount();
INT SetBlockedCertCount(INT iBlockedCertCount);

int secureblackbox_certificatevalidator_getblockedcertcount(void* lpObj);
int secureblackbox_certificatevalidator_setblockedcertcount(void* lpObj, int iBlockedCertCount);

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

Default Value

0

Remarks

This property controls the size of the following arrays:

• BlockedCertBytes
• BlockedCertHandle

The array indices start at 0 and end at BlockedCertCount - 1.

This property is not available at design time.

Data Type

Integer

BlockedCertBytes Property (CertificateValidator Class)

Returns raw certificate data in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetBlockedCertBytes(int iBlockedCertIndex, char* &lpBlockedCertBytes, int &lenBlockedCertBytes);

Unicode (Windows)
INT GetBlockedCertBytes(INT iBlockedCertIndex, LPSTR &lpBlockedCertBytes, INT &lenBlockedCertBytes);

int secureblackbox_certificatevalidator_getblockedcertbytes(void* lpObj, int blockedcertindex, char** lpBlockedCertBytes, int* lenBlockedCertBytes);

QByteArray GetBlockedCertBytes(int iBlockedCertIndex);

Remarks

Returns raw certificate data in DER format.

The BlockedCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the BlockedCertCount property.

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

Data Type

Byte Array

BlockedCertHandle Property (CertificateValidator Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetBlockedCertHandle(int iBlockedCertIndex);
int SetBlockedCertHandle(int iBlockedCertIndex, int64 lBlockedCertHandle);

Unicode (Windows)
LONG64 GetBlockedCertHandle(INT iBlockedCertIndex);
INT SetBlockedCertHandle(INT iBlockedCertIndex, LONG64 lBlockedCertHandle);

int64 secureblackbox_certificatevalidator_getblockedcerthandle(void* lpObj, int blockedcertindex);
int secureblackbox_certificatevalidator_setblockedcerthandle(void* lpObj, int blockedcertindex, int64 lBlockedCertHandle);

qint64 GetBlockedCertHandle(int iBlockedCertIndex);
int SetBlockedCertHandle(int iBlockedCertIndex, qint64 lBlockedCertHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The BlockedCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the BlockedCertCount property.

This property is not available at design time.

Data Type

Long64

CacheValidationResults Property (CertificateValidator Class)

Enables or disables validation result caching.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCacheValidationResults();
int SetCacheValidationResults(int bCacheValidationResults);

Unicode (Windows)
BOOL GetCacheValidationResults();
INT SetCacheValidationResults(BOOL bCacheValidationResults);

int secureblackbox_certificatevalidator_getcachevalidationresults(void* lpObj);
int secureblackbox_certificatevalidator_setcachevalidationresults(void* lpObj, int bCacheValidationResults);

bool GetCacheValidationResults();
int SetCacheValidationResults(bool bCacheValidationResults);

Default Value

FALSE

Remarks

Set this property to True to enable caching of validation results.

Data Type

Boolean

CertBytes Property (CertificateValidator Class)

Returns raw certificate data in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCertBytes(char* &lpCertBytes, int &lenCertBytes);

Unicode (Windows)
INT GetCertBytes(LPSTR &lpCertBytes, INT &lenCertBytes);

int secureblackbox_certificatevalidator_getcertbytes(void* lpObj, char** lpCertBytes, int* lenCertBytes);

QByteArray GetCertBytes();

Remarks

Returns raw certificate data in DER format.

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

Data Type

Byte Array

CertHandle Property (CertificateValidator Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetCertHandle();
int SetCertHandle(int64 lCertHandle);

Unicode (Windows)
LONG64 GetCertHandle();
INT SetCertHandle(LONG64 lCertHandle);

int64 secureblackbox_certificatevalidator_getcerthandle(void* lpObj);
int secureblackbox_certificatevalidator_setcerthandle(void* lpObj, int64 lCertHandle);

qint64 GetCertHandle();
int SetCertHandle(qint64 lCertHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

This property is not available at design time.

Data Type

Long64

ChainValidationDetails Property (CertificateValidator Class)

The details of a certificate chain validation outcome.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChainValidationDetails();

Unicode (Windows)
INT GetChainValidationDetails();

int secureblackbox_certificatevalidator_getchainvalidationdetails(void* lpObj);

int GetChainValidationDetails();

Default Value

0

Remarks

Use the value(s) returned by this property to identify the reasons that contributed to the overall validation result.

Returns a bit mask of the following options:

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

Data Type

Integer

ChainValidationResult Property (CertificateValidator Class)

The general outcome of a certificate chain validation routine. Use ChainValidationDetails to get information about the reasons that contributed to the validation result.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetChainValidationResult();

Unicode (Windows)
INT GetChainValidationResult();

CVT_VALID(0), 
CVT_VALID_BUT_UNTRUSTED(1), 
CVT_INVALID(2), 
CVT_CANT_BE_ESTABLISHED(3)

int secureblackbox_certificatevalidator_getchainvalidationresult(void* lpObj);

int GetChainValidationResult();

Default Value

0

Remarks

Available options:

Use the ValidationLog property to access the detailed validation log.

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

Data Type

Integer

CurrentCACertBytes Property (CertificateValidator Class)

Returns raw certificate data in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertBytes(char* &lpCurrentCACertBytes, int &lenCurrentCACertBytes);

Unicode (Windows)
INT GetCurrentCACertBytes(LPSTR &lpCurrentCACertBytes, INT &lenCurrentCACertBytes);

int secureblackbox_certificatevalidator_getcurrentcacertbytes(void* lpObj, char** lpCurrentCACertBytes, int* lenCurrentCACertBytes);

QByteArray GetCurrentCACertBytes();

Remarks

Returns raw certificate data in DER format.

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

Data Type

Byte Array

CurrentCACertCA Property (CertificateValidator Class)

Indicates whether the certificate has a CA capability (a setting in BasicConstraints extension).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertCA();

Unicode (Windows)
BOOL GetCurrentCACertCA();

int secureblackbox_certificatevalidator_getcurrentcacertca(void* lpObj);

bool GetCurrentCACertCA();

Default Value

FALSE

Remarks

Indicates whether the certificate has a CA capability (a setting in BasicConstraints extension).

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

Data Type

Boolean

CurrentCACertCAKeyID Property (CertificateValidator Class)

A unique identifier (fingerprint) of the CA certificate's private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertCAKeyID(char* &lpCurrentCACertCAKeyID, int &lenCurrentCACertCAKeyID);

Unicode (Windows)
INT GetCurrentCACertCAKeyID(LPSTR &lpCurrentCACertCAKeyID, INT &lenCurrentCACertCAKeyID);

int secureblackbox_certificatevalidator_getcurrentcacertcakeyid(void* lpObj, char** lpCurrentCACertCAKeyID, int* lenCurrentCACertCAKeyID);

QByteArray GetCurrentCACertCAKeyID();

Remarks

A unique identifier (fingerprint) of the CA certificate's private key.

Authority Key Identifier is a (non-critical) X.509 certificate extension which allows the identification of certificates produced by the same issuer, but with different public keys.

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

Data Type

Byte Array

CurrentCACertCRLDistributionPoints Property (CertificateValidator Class)

Locations of the CRL (Certificate Revocation List) distribution points used to check this certificate's validity.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertCRLDistributionPoints();

Unicode (Windows)
LPWSTR GetCurrentCACertCRLDistributionPoints();

char* secureblackbox_certificatevalidator_getcurrentcacertcrldistributionpoints(void* lpObj);

QString GetCurrentCACertCRLDistributionPoints();

Default Value

""

Remarks

Locations of the CRL (Certificate Revocation List) distribution points used to check this certificate's validity.

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

Data Type

String

CurrentCACertCurve Property (CertificateValidator Class)

Specifies the elliptic curve of the EC public key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertCurve();

Unicode (Windows)
LPWSTR GetCurrentCACertCurve();

char* secureblackbox_certificatevalidator_getcurrentcacertcurve(void* lpObj);

QString GetCurrentCACertCurve();

Default Value

""

Remarks

Specifies the elliptic curve of the EC public key.

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

Data Type

String

CurrentCACertFingerprint Property (CertificateValidator Class)

Contains the fingerprint (a hash imprint) of this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertFingerprint(char* &lpCurrentCACertFingerprint, int &lenCurrentCACertFingerprint);

Unicode (Windows)
INT GetCurrentCACertFingerprint(LPSTR &lpCurrentCACertFingerprint, INT &lenCurrentCACertFingerprint);

int secureblackbox_certificatevalidator_getcurrentcacertfingerprint(void* lpObj, char** lpCurrentCACertFingerprint, int* lenCurrentCACertFingerprint);

QByteArray GetCurrentCACertFingerprint();

Remarks

Contains the fingerprint (a hash imprint) of this certificate.

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

Data Type

Byte Array

CurrentCACertFriendlyName Property (CertificateValidator Class)

Contains an associated alias (friendly name) of the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertFriendlyName();

Unicode (Windows)
LPWSTR GetCurrentCACertFriendlyName();

char* secureblackbox_certificatevalidator_getcurrentcacertfriendlyname(void* lpObj);

QString GetCurrentCACertFriendlyName();

Default Value

""

Remarks

Contains an associated alias (friendly name) of the certificate.

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

Data Type

String

CurrentCACertHandle Property (CertificateValidator Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetCurrentCACertHandle();

Unicode (Windows)
LONG64 GetCurrentCACertHandle();

int64 secureblackbox_certificatevalidator_getcurrentcacerthandle(void* lpObj);

qint64 GetCurrentCACertHandle();

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

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

Data Type

Long64

CurrentCACertHashAlgorithm Property (CertificateValidator Class)

Specifies the hash algorithm to be used in the operations on the certificate (such as key signing) SB_HASH_ALGORITHM_SHA1 SHA1 SB_HASH_ALGORITHM_SHA224 SHA224 SB_HASH_ALGORITHM_SHA256 SHA256 SB_HASH_ALGORITHM_SHA384 SHA384 SB_HASH_ALGORITHM_SHA512 SHA512 SB_HASH_ALGORITHM_MD2 MD2 SB_HASH_ALGORITHM_MD4 MD4 SB_HASH_ALGORITHM_MD5 MD5 SB_HASH_ALGORITHM_RIPEMD160 RIPEMD160 SB_HASH_ALGORITHM_CRC32 CRC32 SB_HASH_ALGORITHM_SSL3 SSL3 SB_HASH_ALGORITHM_GOST_R3411_1994 GOST1994 SB_HASH_ALGORITHM_WHIRLPOOL WHIRLPOOL SB_HASH_ALGORITHM_POLY1305 POLY1305 SB_HASH_ALGORITHM_SHA3_224 SHA3_224 SB_HASH_ALGORITHM_SHA3_256 SHA3_256 SB_HASH_ALGORITHM_SHA3_384 SHA3_384 SB_HASH_ALGORITHM_SHA3_512 SHA3_512 SB_HASH_ALGORITHM_BLAKE2S_128 BLAKE2S_128 SB_HASH_ALGORITHM_BLAKE2S_160 BLAKE2S_160 SB_HASH_ALGORITHM_BLAKE2S_224 BLAKE2S_224 SB_HASH_ALGORITHM_BLAKE2S_256 BLAKE2S_256 SB_HASH_ALGORITHM_BLAKE2B_160 BLAKE2B_160 SB_HASH_ALGORITHM_BLAKE2B_256 BLAKE2B_256 SB_HASH_ALGORITHM_BLAKE2B_384 BLAKE2B_384 SB_HASH_ALGORITHM_BLAKE2B_512 BLAKE2B_512 SB_HASH_ALGORITHM_SHAKE_128 SHAKE_128 SB_HASH_ALGORITHM_SHAKE_256 SHAKE_256 SB_HASH_ALGORITHM_SHAKE_128_LEN SHAKE_128_LEN SB_HASH_ALGORITHM_SHAKE_256_LEN SHAKE_256_LEN .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertHashAlgorithm();

Unicode (Windows)
LPWSTR GetCurrentCACertHashAlgorithm();

char* secureblackbox_certificatevalidator_getcurrentcacerthashalgorithm(void* lpObj);

QString GetCurrentCACertHashAlgorithm();

Default Value

""

Remarks

Specifies the hash algorithm to be used in the operations on the certificate (such as key signing)

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

Data Type

String

CurrentCACertIssuer Property (CertificateValidator Class)

The common name of the certificate issuer (CA), typically a company name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertIssuer();

Unicode (Windows)
LPWSTR GetCurrentCACertIssuer();

char* secureblackbox_certificatevalidator_getcurrentcacertissuer(void* lpObj);

QString GetCurrentCACertIssuer();

Default Value

""

Remarks

The common name of the certificate issuer (CA), typically a company name.

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

Data Type

String

CurrentCACertIssuerRDN Property (CertificateValidator Class)

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate issuer.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertIssuerRDN();

Unicode (Windows)
LPWSTR GetCurrentCACertIssuerRDN();

char* secureblackbox_certificatevalidator_getcurrentcacertissuerrdn(void* lpObj);

QString GetCurrentCACertIssuerRDN();

Default Value

""

Remarks

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate issuer.

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

Data Type

String

CurrentCACertKeyAlgorithm Property (CertificateValidator Class)

Specifies the public key algorithm of this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertKeyAlgorithm();

Unicode (Windows)
LPWSTR GetCurrentCACertKeyAlgorithm();

char* secureblackbox_certificatevalidator_getcurrentcacertkeyalgorithm(void* lpObj);

QString GetCurrentCACertKeyAlgorithm();

Default Value

"0"

Remarks

Specifies the public key algorithm of this certificate.

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

Data Type

String

CurrentCACertKeyBits Property (CertificateValidator Class)

Returns the length of the public key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertKeyBits();

Unicode (Windows)
INT GetCurrentCACertKeyBits();

int secureblackbox_certificatevalidator_getcurrentcacertkeybits(void* lpObj);

int GetCurrentCACertKeyBits();

Default Value

0

Remarks

Returns the length of the public key.

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

Data Type

Integer

CurrentCACertKeyFingerprint Property (CertificateValidator Class)

Returns a fingerprint of the public key contained in the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertKeyFingerprint(char* &lpCurrentCACertKeyFingerprint, int &lenCurrentCACertKeyFingerprint);

Unicode (Windows)
INT GetCurrentCACertKeyFingerprint(LPSTR &lpCurrentCACertKeyFingerprint, INT &lenCurrentCACertKeyFingerprint);

int secureblackbox_certificatevalidator_getcurrentcacertkeyfingerprint(void* lpObj, char** lpCurrentCACertKeyFingerprint, int* lenCurrentCACertKeyFingerprint);

QByteArray GetCurrentCACertKeyFingerprint();

Remarks

Returns a fingerprint of the public key contained in the certificate.

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

Data Type

Byte Array

CurrentCACertKeyUsage Property (CertificateValidator Class)

Indicates the purposes of the key contained in the certificate, in the form of an OR'ed flag set.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertKeyUsage();

Unicode (Windows)
INT GetCurrentCACertKeyUsage();

int secureblackbox_certificatevalidator_getcurrentcacertkeyusage(void* lpObj);

int GetCurrentCACertKeyUsage();

Default Value

0

Remarks

Indicates the purposes of the key contained in the certificate, in the form of an OR'ed flag set.

This value is a bit mask of the following values:

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

Data Type

Integer

CurrentCACertKeyValid Property (CertificateValidator Class)

Returns True if the certificate's key is cryptographically valid, and False otherwise.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertKeyValid();

Unicode (Windows)
BOOL GetCurrentCACertKeyValid();

int secureblackbox_certificatevalidator_getcurrentcacertkeyvalid(void* lpObj);

bool GetCurrentCACertKeyValid();

Default Value

FALSE

Remarks

Returns True if the certificate's key is cryptographically valid, and False otherwise.

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

Data Type

Boolean

CurrentCACertOCSPLocations Property (CertificateValidator Class)

Locations of OCSP (Online Certificate Status Protocol) services that can be used to check this certificate's validity, as recorded by the CA.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertOCSPLocations();

Unicode (Windows)
LPWSTR GetCurrentCACertOCSPLocations();

char* secureblackbox_certificatevalidator_getcurrentcacertocsplocations(void* lpObj);

QString GetCurrentCACertOCSPLocations();

Default Value

""

Remarks

Locations of OCSP (Online Certificate Status Protocol) services that can be used to check this certificate's validity, as recorded by the CA.

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

Data Type

String

CurrentCACertOCSPNoCheck Property (CertificateValidator Class)

Accessor to the value of the certificates ocsp-no-check extension.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertOCSPNoCheck();

Unicode (Windows)
BOOL GetCurrentCACertOCSPNoCheck();

int secureblackbox_certificatevalidator_getcurrentcacertocspnocheck(void* lpObj);

bool GetCurrentCACertOCSPNoCheck();

Default Value

FALSE

Remarks

Accessor to the value of the certificates ocsp-no-check extension.

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

Data Type

Boolean

CurrentCACertOrigin Property (CertificateValidator Class)

Returns the origin of this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertOrigin();

Unicode (Windows)
INT GetCurrentCACertOrigin();

int secureblackbox_certificatevalidator_getcurrentcacertorigin(void* lpObj);

int GetCurrentCACertOrigin();

Default Value

0

Remarks

Returns the origin of this certificate.

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

Data Type

Integer

CurrentCACertPolicyIDs Property (CertificateValidator Class)

Contains identifiers (OIDs) of the applicable certificate policies.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertPolicyIDs();

Unicode (Windows)
LPWSTR GetCurrentCACertPolicyIDs();

char* secureblackbox_certificatevalidator_getcurrentcacertpolicyids(void* lpObj);

QString GetCurrentCACertPolicyIDs();

Default Value

""

Remarks

Contains identifiers (OIDs) of the applicable certificate policies.

The Certificate Policies extension identifies a sequence of policies under which the certificate has been issued, and which regulate its usage.

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

Data Type

String

CurrentCACertPrivateKeyBytes Property (CertificateValidator Class)

Contains the certificate's private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertPrivateKeyBytes(char* &lpCurrentCACertPrivateKeyBytes, int &lenCurrentCACertPrivateKeyBytes);

Unicode (Windows)
INT GetCurrentCACertPrivateKeyBytes(LPSTR &lpCurrentCACertPrivateKeyBytes, INT &lenCurrentCACertPrivateKeyBytes);

int secureblackbox_certificatevalidator_getcurrentcacertprivatekeybytes(void* lpObj, char** lpCurrentCACertPrivateKeyBytes, int* lenCurrentCACertPrivateKeyBytes);

QByteArray GetCurrentCACertPrivateKeyBytes();

Remarks

Contains the certificate's private key. It is normal for this property to be empty if the private key is non-exportable.

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

Data Type

Byte Array

CurrentCACertPrivateKeyExists Property (CertificateValidator Class)

Indicates whether the certificate has an associated private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertPrivateKeyExists();

Unicode (Windows)
BOOL GetCurrentCACertPrivateKeyExists();

int secureblackbox_certificatevalidator_getcurrentcacertprivatekeyexists(void* lpObj);

bool GetCurrentCACertPrivateKeyExists();

Default Value

FALSE

Remarks

Indicates whether the certificate has an associated private key.

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

Data Type

Boolean

CurrentCACertPrivateKeyExtractable Property (CertificateValidator Class)

Indicates whether the private key is extractable.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertPrivateKeyExtractable();

Unicode (Windows)
BOOL GetCurrentCACertPrivateKeyExtractable();

int secureblackbox_certificatevalidator_getcurrentcacertprivatekeyextractable(void* lpObj);

bool GetCurrentCACertPrivateKeyExtractable();

Default Value

FALSE

Remarks

Indicates whether the private key is extractable

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

Data Type

Boolean

CurrentCACertPublicKeyBytes Property (CertificateValidator Class)

Contains the certificate's public key in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertPublicKeyBytes(char* &lpCurrentCACertPublicKeyBytes, int &lenCurrentCACertPublicKeyBytes);

Unicode (Windows)
INT GetCurrentCACertPublicKeyBytes(LPSTR &lpCurrentCACertPublicKeyBytes, INT &lenCurrentCACertPublicKeyBytes);

int secureblackbox_certificatevalidator_getcurrentcacertpublickeybytes(void* lpObj, char** lpCurrentCACertPublicKeyBytes, int* lenCurrentCACertPublicKeyBytes);

QByteArray GetCurrentCACertPublicKeyBytes();

Remarks

Contains the certificate's public key in DER format.

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

Data Type

Byte Array

CurrentCACertQualifiedStatements Property (CertificateValidator Class)

Returns the qualified status of the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertQualifiedStatements();

Unicode (Windows)
INT GetCurrentCACertQualifiedStatements();

QST_NON_QUALIFIED(0), 
QST_QUALIFIED_HARDWARE(1), 
QST_QUALIFIED_SOFTWARE(2)

int secureblackbox_certificatevalidator_getcurrentcacertqualifiedstatements(void* lpObj);

int GetCurrentCACertQualifiedStatements();

Default Value

0

Remarks

Returns the qualified status of the certificate.

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

Data Type

Integer

CurrentCACertSelfSigned Property (CertificateValidator Class)

Indicates whether the certificate is self-signed (root) or signed by an external CA.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertSelfSigned();

Unicode (Windows)
BOOL GetCurrentCACertSelfSigned();

int secureblackbox_certificatevalidator_getcurrentcacertselfsigned(void* lpObj);

bool GetCurrentCACertSelfSigned();

Default Value

FALSE

Remarks

Indicates whether the certificate is self-signed (root) or signed by an external CA.

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

Data Type

Boolean

CurrentCACertSerialNumber Property (CertificateValidator Class)

Returns the certificate's serial number.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertSerialNumber(char* &lpCurrentCACertSerialNumber, int &lenCurrentCACertSerialNumber);

Unicode (Windows)
INT GetCurrentCACertSerialNumber(LPSTR &lpCurrentCACertSerialNumber, INT &lenCurrentCACertSerialNumber);

int secureblackbox_certificatevalidator_getcurrentcacertserialnumber(void* lpObj, char** lpCurrentCACertSerialNumber, int* lenCurrentCACertSerialNumber);

QByteArray GetCurrentCACertSerialNumber();

Remarks

Returns the certificate's serial number.

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

Data Type

Byte Array

CurrentCACertSigAlgorithm Property (CertificateValidator Class)

Indicates the algorithm that was used by the CA to sign this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertSigAlgorithm();

Unicode (Windows)
LPWSTR GetCurrentCACertSigAlgorithm();

char* secureblackbox_certificatevalidator_getcurrentcacertsigalgorithm(void* lpObj);

QString GetCurrentCACertSigAlgorithm();

Default Value

""

Remarks

Indicates the algorithm that was used by the CA to sign this certificate.

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

Data Type

String

CurrentCACertSubject Property (CertificateValidator Class)

The common name of the certificate holder, typically an individual's name, a URL, an e-mail address, or a company name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertSubject();

Unicode (Windows)
LPWSTR GetCurrentCACertSubject();

char* secureblackbox_certificatevalidator_getcurrentcacertsubject(void* lpObj);

QString GetCurrentCACertSubject();

Default Value

""

Remarks

The common name of the certificate holder, typically an individual's name, a URL, an e-mail address, or a company name.

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

Data Type

String

CurrentCACertSubjectAlternativeName Property (CertificateValidator Class)

Returns or sets the value of the Subject Alternative Name extension of the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertSubjectAlternativeName();

Unicode (Windows)
LPWSTR GetCurrentCACertSubjectAlternativeName();

char* secureblackbox_certificatevalidator_getcurrentcacertsubjectalternativename(void* lpObj);

QString GetCurrentCACertSubjectAlternativeName();

Default Value

""

Remarks

Returns or sets the value of the Subject Alternative Name extension of the certificate.

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

Data Type

String

CurrentCACertSubjectKeyID Property (CertificateValidator Class)

Contains a unique identifier (fingerprint) of the certificate's private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCACertSubjectKeyID(char* &lpCurrentCACertSubjectKeyID, int &lenCurrentCACertSubjectKeyID);

Unicode (Windows)
INT GetCurrentCACertSubjectKeyID(LPSTR &lpCurrentCACertSubjectKeyID, INT &lenCurrentCACertSubjectKeyID);

int secureblackbox_certificatevalidator_getcurrentcacertsubjectkeyid(void* lpObj, char** lpCurrentCACertSubjectKeyID, int* lenCurrentCACertSubjectKeyID);

QByteArray GetCurrentCACertSubjectKeyID();

Remarks

Contains a unique identifier (fingerprint) of the certificate's private key.

Subject Key Identifier is a (non-critical) X.509 certificate extension which allows the identification of certificates containing a particular public key. In SecureBlackbox, the unique identifier is represented with a SHA1 hash of the bit string of the subject public key.

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

Data Type

Byte Array

CurrentCACertSubjectRDN Property (CertificateValidator Class)

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate holder (subject).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertSubjectRDN();

Unicode (Windows)
LPWSTR GetCurrentCACertSubjectRDN();

char* secureblackbox_certificatevalidator_getcurrentcacertsubjectrdn(void* lpObj);

QString GetCurrentCACertSubjectRDN();

Default Value

""

Remarks

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate holder (subject).

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

Data Type

String

CurrentCACertValidFrom Property (CertificateValidator Class)

The time point at which the certificate becomes valid, in UTC.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertValidFrom();

Unicode (Windows)
LPWSTR GetCurrentCACertValidFrom();

char* secureblackbox_certificatevalidator_getcurrentcacertvalidfrom(void* lpObj);

QString GetCurrentCACertValidFrom();

Default Value

""

Remarks

The time point at which the certificate becomes valid, in UTC.

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

Data Type

String

CurrentCACertValidTo Property (CertificateValidator Class)

The time point at which the certificate expires, in UTC.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCACertValidTo();

Unicode (Windows)
LPWSTR GetCurrentCACertValidTo();

char* secureblackbox_certificatevalidator_getcurrentcacertvalidto(void* lpObj);

QString GetCurrentCACertValidTo();

Default Value

""

Remarks

The time point at which the certificate expires, in UTC.

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

Data Type

String

CurrentCertBytes Property (CertificateValidator Class)

Returns raw certificate data in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertBytes(char* &lpCurrentCertBytes, int &lenCurrentCertBytes);

Unicode (Windows)
INT GetCurrentCertBytes(LPSTR &lpCurrentCertBytes, INT &lenCurrentCertBytes);

int secureblackbox_certificatevalidator_getcurrentcertbytes(void* lpObj, char** lpCurrentCertBytes, int* lenCurrentCertBytes);

QByteArray GetCurrentCertBytes();

Remarks

Returns raw certificate data in DER format.

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

Data Type

Byte Array

CurrentCertCA Property (CertificateValidator Class)

Indicates whether the certificate has a CA capability (a setting in BasicConstraints extension).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertCA();

Unicode (Windows)
BOOL GetCurrentCertCA();

int secureblackbox_certificatevalidator_getcurrentcertca(void* lpObj);

bool GetCurrentCertCA();

Default Value

FALSE

Remarks

Indicates whether the certificate has a CA capability (a setting in BasicConstraints extension).

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

Data Type

Boolean

CurrentCertCAKeyID Property (CertificateValidator Class)

A unique identifier (fingerprint) of the CA certificate's private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertCAKeyID(char* &lpCurrentCertCAKeyID, int &lenCurrentCertCAKeyID);

Unicode (Windows)
INT GetCurrentCertCAKeyID(LPSTR &lpCurrentCertCAKeyID, INT &lenCurrentCertCAKeyID);

int secureblackbox_certificatevalidator_getcurrentcertcakeyid(void* lpObj, char** lpCurrentCertCAKeyID, int* lenCurrentCertCAKeyID);

QByteArray GetCurrentCertCAKeyID();

Remarks

A unique identifier (fingerprint) of the CA certificate's private key.

Authority Key Identifier is a (non-critical) X.509 certificate extension which allows the identification of certificates produced by the same issuer, but with different public keys.

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

Data Type

Byte Array

CurrentCertCRLDistributionPoints Property (CertificateValidator Class)

Locations of the CRL (Certificate Revocation List) distribution points used to check this certificate's validity.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertCRLDistributionPoints();

Unicode (Windows)
LPWSTR GetCurrentCertCRLDistributionPoints();

char* secureblackbox_certificatevalidator_getcurrentcertcrldistributionpoints(void* lpObj);

QString GetCurrentCertCRLDistributionPoints();

Default Value

""

Remarks

Locations of the CRL (Certificate Revocation List) distribution points used to check this certificate's validity.

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

Data Type

String

CurrentCertCurve Property (CertificateValidator Class)

Specifies the elliptic curve of the EC public key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertCurve();

Unicode (Windows)
LPWSTR GetCurrentCertCurve();

char* secureblackbox_certificatevalidator_getcurrentcertcurve(void* lpObj);

QString GetCurrentCertCurve();

Default Value

""

Remarks

Specifies the elliptic curve of the EC public key.

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

Data Type

String

CurrentCertFingerprint Property (CertificateValidator Class)

Contains the fingerprint (a hash imprint) of this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertFingerprint(char* &lpCurrentCertFingerprint, int &lenCurrentCertFingerprint);

Unicode (Windows)
INT GetCurrentCertFingerprint(LPSTR &lpCurrentCertFingerprint, INT &lenCurrentCertFingerprint);

int secureblackbox_certificatevalidator_getcurrentcertfingerprint(void* lpObj, char** lpCurrentCertFingerprint, int* lenCurrentCertFingerprint);

QByteArray GetCurrentCertFingerprint();

Remarks

Contains the fingerprint (a hash imprint) of this certificate.

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

Data Type

Byte Array

CurrentCertFriendlyName Property (CertificateValidator Class)

Contains an associated alias (friendly name) of the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertFriendlyName();

Unicode (Windows)
LPWSTR GetCurrentCertFriendlyName();

char* secureblackbox_certificatevalidator_getcurrentcertfriendlyname(void* lpObj);

QString GetCurrentCertFriendlyName();

Default Value

""

Remarks

Contains an associated alias (friendly name) of the certificate.

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

Data Type

String

CurrentCertHandle Property (CertificateValidator Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetCurrentCertHandle();

Unicode (Windows)
LONG64 GetCurrentCertHandle();

int64 secureblackbox_certificatevalidator_getcurrentcerthandle(void* lpObj);

qint64 GetCurrentCertHandle();

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

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

Data Type

Long64

CurrentCertHashAlgorithm Property (CertificateValidator Class)

Specifies the hash algorithm to be used in the operations on the certificate (such as key signing) SB_HASH_ALGORITHM_SHA1 SHA1 SB_HASH_ALGORITHM_SHA224 SHA224 SB_HASH_ALGORITHM_SHA256 SHA256 SB_HASH_ALGORITHM_SHA384 SHA384 SB_HASH_ALGORITHM_SHA512 SHA512 SB_HASH_ALGORITHM_MD2 MD2 SB_HASH_ALGORITHM_MD4 MD4 SB_HASH_ALGORITHM_MD5 MD5 SB_HASH_ALGORITHM_RIPEMD160 RIPEMD160 SB_HASH_ALGORITHM_CRC32 CRC32 SB_HASH_ALGORITHM_SSL3 SSL3 SB_HASH_ALGORITHM_GOST_R3411_1994 GOST1994 SB_HASH_ALGORITHM_WHIRLPOOL WHIRLPOOL SB_HASH_ALGORITHM_POLY1305 POLY1305 SB_HASH_ALGORITHM_SHA3_224 SHA3_224 SB_HASH_ALGORITHM_SHA3_256 SHA3_256 SB_HASH_ALGORITHM_SHA3_384 SHA3_384 SB_HASH_ALGORITHM_SHA3_512 SHA3_512 SB_HASH_ALGORITHM_BLAKE2S_128 BLAKE2S_128 SB_HASH_ALGORITHM_BLAKE2S_160 BLAKE2S_160 SB_HASH_ALGORITHM_BLAKE2S_224 BLAKE2S_224 SB_HASH_ALGORITHM_BLAKE2S_256 BLAKE2S_256 SB_HASH_ALGORITHM_BLAKE2B_160 BLAKE2B_160 SB_HASH_ALGORITHM_BLAKE2B_256 BLAKE2B_256 SB_HASH_ALGORITHM_BLAKE2B_384 BLAKE2B_384 SB_HASH_ALGORITHM_BLAKE2B_512 BLAKE2B_512 SB_HASH_ALGORITHM_SHAKE_128 SHAKE_128 SB_HASH_ALGORITHM_SHAKE_256 SHAKE_256 SB_HASH_ALGORITHM_SHAKE_128_LEN SHAKE_128_LEN SB_HASH_ALGORITHM_SHAKE_256_LEN SHAKE_256_LEN .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertHashAlgorithm();

Unicode (Windows)
LPWSTR GetCurrentCertHashAlgorithm();

char* secureblackbox_certificatevalidator_getcurrentcerthashalgorithm(void* lpObj);

QString GetCurrentCertHashAlgorithm();

Default Value

""

Remarks

Specifies the hash algorithm to be used in the operations on the certificate (such as key signing)

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

Data Type

String

CurrentCertIssuer Property (CertificateValidator Class)

The common name of the certificate issuer (CA), typically a company name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertIssuer();

Unicode (Windows)
LPWSTR GetCurrentCertIssuer();

char* secureblackbox_certificatevalidator_getcurrentcertissuer(void* lpObj);

QString GetCurrentCertIssuer();

Default Value

""

Remarks

The common name of the certificate issuer (CA), typically a company name.

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

Data Type

String

CurrentCertIssuerRDN Property (CertificateValidator Class)

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate issuer.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertIssuerRDN();

Unicode (Windows)
LPWSTR GetCurrentCertIssuerRDN();

char* secureblackbox_certificatevalidator_getcurrentcertissuerrdn(void* lpObj);

QString GetCurrentCertIssuerRDN();

Default Value

""

Remarks

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate issuer.

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

Data Type

String

CurrentCertKeyAlgorithm Property (CertificateValidator Class)

Specifies the public key algorithm of this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertKeyAlgorithm();

Unicode (Windows)
LPWSTR GetCurrentCertKeyAlgorithm();

char* secureblackbox_certificatevalidator_getcurrentcertkeyalgorithm(void* lpObj);

QString GetCurrentCertKeyAlgorithm();

Default Value

"0"

Remarks

Specifies the public key algorithm of this certificate.

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

Data Type

String

CurrentCertKeyBits Property (CertificateValidator Class)

Returns the length of the public key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertKeyBits();

Unicode (Windows)
INT GetCurrentCertKeyBits();

int secureblackbox_certificatevalidator_getcurrentcertkeybits(void* lpObj);

int GetCurrentCertKeyBits();

Default Value

0

Remarks

Returns the length of the public key.

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

Data Type

Integer

CurrentCertKeyFingerprint Property (CertificateValidator Class)

Returns a fingerprint of the public key contained in the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertKeyFingerprint(char* &lpCurrentCertKeyFingerprint, int &lenCurrentCertKeyFingerprint);

Unicode (Windows)
INT GetCurrentCertKeyFingerprint(LPSTR &lpCurrentCertKeyFingerprint, INT &lenCurrentCertKeyFingerprint);

int secureblackbox_certificatevalidator_getcurrentcertkeyfingerprint(void* lpObj, char** lpCurrentCertKeyFingerprint, int* lenCurrentCertKeyFingerprint);

QByteArray GetCurrentCertKeyFingerprint();

Remarks

Returns a fingerprint of the public key contained in the certificate.

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

Data Type

Byte Array

CurrentCertKeyUsage Property (CertificateValidator Class)

Indicates the purposes of the key contained in the certificate, in the form of an OR'ed flag set.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertKeyUsage();

Unicode (Windows)
INT GetCurrentCertKeyUsage();

int secureblackbox_certificatevalidator_getcurrentcertkeyusage(void* lpObj);

int GetCurrentCertKeyUsage();

Default Value

0

Remarks

Indicates the purposes of the key contained in the certificate, in the form of an OR'ed flag set.

This value is a bit mask of the following values:

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

Data Type

Integer

CurrentCertKeyValid Property (CertificateValidator Class)

Returns True if the certificate's key is cryptographically valid, and False otherwise.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertKeyValid();

Unicode (Windows)
BOOL GetCurrentCertKeyValid();

int secureblackbox_certificatevalidator_getcurrentcertkeyvalid(void* lpObj);

bool GetCurrentCertKeyValid();

Default Value

FALSE

Remarks

Returns True if the certificate's key is cryptographically valid, and False otherwise.

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

Data Type

Boolean

CurrentCertOCSPLocations Property (CertificateValidator Class)

Locations of OCSP (Online Certificate Status Protocol) services that can be used to check this certificate's validity, as recorded by the CA.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertOCSPLocations();

Unicode (Windows)
LPWSTR GetCurrentCertOCSPLocations();

char* secureblackbox_certificatevalidator_getcurrentcertocsplocations(void* lpObj);

QString GetCurrentCertOCSPLocations();

Default Value

""

Remarks

Locations of OCSP (Online Certificate Status Protocol) services that can be used to check this certificate's validity, as recorded by the CA.

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

Data Type

String

CurrentCertOCSPNoCheck Property (CertificateValidator Class)

Accessor to the value of the certificates ocsp-no-check extension.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertOCSPNoCheck();

Unicode (Windows)
BOOL GetCurrentCertOCSPNoCheck();

int secureblackbox_certificatevalidator_getcurrentcertocspnocheck(void* lpObj);

bool GetCurrentCertOCSPNoCheck();

Default Value

FALSE

Remarks

Accessor to the value of the certificates ocsp-no-check extension.

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

Data Type

Boolean

CurrentCertOrigin Property (CertificateValidator Class)

Returns the origin of this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertOrigin();

Unicode (Windows)
INT GetCurrentCertOrigin();

int secureblackbox_certificatevalidator_getcurrentcertorigin(void* lpObj);

int GetCurrentCertOrigin();

Default Value

0

Remarks

Returns the origin of this certificate.

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

Data Type

Integer

CurrentCertPolicyIDs Property (CertificateValidator Class)

Contains identifiers (OIDs) of the applicable certificate policies.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertPolicyIDs();

Unicode (Windows)
LPWSTR GetCurrentCertPolicyIDs();

char* secureblackbox_certificatevalidator_getcurrentcertpolicyids(void* lpObj);

QString GetCurrentCertPolicyIDs();

Default Value

""

Remarks

Contains identifiers (OIDs) of the applicable certificate policies.

The Certificate Policies extension identifies a sequence of policies under which the certificate has been issued, and which regulate its usage.

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

Data Type

String

CurrentCertPrivateKeyBytes Property (CertificateValidator Class)

Contains the certificate's private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertPrivateKeyBytes(char* &lpCurrentCertPrivateKeyBytes, int &lenCurrentCertPrivateKeyBytes);

Unicode (Windows)
INT GetCurrentCertPrivateKeyBytes(LPSTR &lpCurrentCertPrivateKeyBytes, INT &lenCurrentCertPrivateKeyBytes);

int secureblackbox_certificatevalidator_getcurrentcertprivatekeybytes(void* lpObj, char** lpCurrentCertPrivateKeyBytes, int* lenCurrentCertPrivateKeyBytes);

QByteArray GetCurrentCertPrivateKeyBytes();

Remarks

Contains the certificate's private key. It is normal for this property to be empty if the private key is non-exportable.

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

Data Type

Byte Array

CurrentCertPrivateKeyExists Property (CertificateValidator Class)

Indicates whether the certificate has an associated private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertPrivateKeyExists();

Unicode (Windows)
BOOL GetCurrentCertPrivateKeyExists();

int secureblackbox_certificatevalidator_getcurrentcertprivatekeyexists(void* lpObj);

bool GetCurrentCertPrivateKeyExists();

Default Value

FALSE

Remarks

Indicates whether the certificate has an associated private key.

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

Data Type

Boolean

CurrentCertPrivateKeyExtractable Property (CertificateValidator Class)

Indicates whether the private key is extractable.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertPrivateKeyExtractable();

Unicode (Windows)
BOOL GetCurrentCertPrivateKeyExtractable();

int secureblackbox_certificatevalidator_getcurrentcertprivatekeyextractable(void* lpObj);

bool GetCurrentCertPrivateKeyExtractable();

Default Value

FALSE

Remarks

Indicates whether the private key is extractable

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

Data Type

Boolean

CurrentCertPublicKeyBytes Property (CertificateValidator Class)

Contains the certificate's public key in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertPublicKeyBytes(char* &lpCurrentCertPublicKeyBytes, int &lenCurrentCertPublicKeyBytes);

Unicode (Windows)
INT GetCurrentCertPublicKeyBytes(LPSTR &lpCurrentCertPublicKeyBytes, INT &lenCurrentCertPublicKeyBytes);

int secureblackbox_certificatevalidator_getcurrentcertpublickeybytes(void* lpObj, char** lpCurrentCertPublicKeyBytes, int* lenCurrentCertPublicKeyBytes);

QByteArray GetCurrentCertPublicKeyBytes();

Remarks

Contains the certificate's public key in DER format.

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

Data Type

Byte Array

CurrentCertQualifiedStatements Property (CertificateValidator Class)

Returns the qualified status of the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertQualifiedStatements();

Unicode (Windows)
INT GetCurrentCertQualifiedStatements();

QST_NON_QUALIFIED(0), 
QST_QUALIFIED_HARDWARE(1), 
QST_QUALIFIED_SOFTWARE(2)

int secureblackbox_certificatevalidator_getcurrentcertqualifiedstatements(void* lpObj);

int GetCurrentCertQualifiedStatements();

Default Value

0

Remarks

Returns the qualified status of the certificate.

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

Data Type

Integer

CurrentCertSelfSigned Property (CertificateValidator Class)

Indicates whether the certificate is self-signed (root) or signed by an external CA.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertSelfSigned();

Unicode (Windows)
BOOL GetCurrentCertSelfSigned();

int secureblackbox_certificatevalidator_getcurrentcertselfsigned(void* lpObj);

bool GetCurrentCertSelfSigned();

Default Value

FALSE

Remarks

Indicates whether the certificate is self-signed (root) or signed by an external CA.

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

Data Type

Boolean

CurrentCertSerialNumber Property (CertificateValidator Class)

Returns the certificate's serial number.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertSerialNumber(char* &lpCurrentCertSerialNumber, int &lenCurrentCertSerialNumber);

Unicode (Windows)
INT GetCurrentCertSerialNumber(LPSTR &lpCurrentCertSerialNumber, INT &lenCurrentCertSerialNumber);

int secureblackbox_certificatevalidator_getcurrentcertserialnumber(void* lpObj, char** lpCurrentCertSerialNumber, int* lenCurrentCertSerialNumber);

QByteArray GetCurrentCertSerialNumber();

Remarks

Returns the certificate's serial number.

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

Data Type

Byte Array

CurrentCertSigAlgorithm Property (CertificateValidator Class)

Indicates the algorithm that was used by the CA to sign this certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertSigAlgorithm();

Unicode (Windows)
LPWSTR GetCurrentCertSigAlgorithm();

char* secureblackbox_certificatevalidator_getcurrentcertsigalgorithm(void* lpObj);

QString GetCurrentCertSigAlgorithm();

Default Value

""

Remarks

Indicates the algorithm that was used by the CA to sign this certificate.

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

Data Type

String

CurrentCertSubject Property (CertificateValidator Class)

The common name of the certificate holder, typically an individual's name, a URL, an e-mail address, or a company name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertSubject();

Unicode (Windows)
LPWSTR GetCurrentCertSubject();

char* secureblackbox_certificatevalidator_getcurrentcertsubject(void* lpObj);

QString GetCurrentCertSubject();

Default Value

""

Remarks

The common name of the certificate holder, typically an individual's name, a URL, an e-mail address, or a company name.

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

Data Type

String

CurrentCertSubjectAlternativeName Property (CertificateValidator Class)

Returns or sets the value of the Subject Alternative Name extension of the certificate.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertSubjectAlternativeName();

Unicode (Windows)
LPWSTR GetCurrentCertSubjectAlternativeName();

char* secureblackbox_certificatevalidator_getcurrentcertsubjectalternativename(void* lpObj);

QString GetCurrentCertSubjectAlternativeName();

Default Value

""

Remarks

Returns or sets the value of the Subject Alternative Name extension of the certificate.

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

Data Type

String

CurrentCertSubjectKeyID Property (CertificateValidator Class)

Contains a unique identifier (fingerprint) of the certificate's private key.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCurrentCertSubjectKeyID(char* &lpCurrentCertSubjectKeyID, int &lenCurrentCertSubjectKeyID);

Unicode (Windows)
INT GetCurrentCertSubjectKeyID(LPSTR &lpCurrentCertSubjectKeyID, INT &lenCurrentCertSubjectKeyID);

int secureblackbox_certificatevalidator_getcurrentcertsubjectkeyid(void* lpObj, char** lpCurrentCertSubjectKeyID, int* lenCurrentCertSubjectKeyID);

QByteArray GetCurrentCertSubjectKeyID();

Remarks

Contains a unique identifier (fingerprint) of the certificate's private key.

Subject Key Identifier is a (non-critical) X.509 certificate extension which allows the identification of certificates containing a particular public key. In SecureBlackbox, the unique identifier is represented with a SHA1 hash of the bit string of the subject public key.

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

Data Type

Byte Array

CurrentCertSubjectRDN Property (CertificateValidator Class)

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate holder (subject).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertSubjectRDN();

Unicode (Windows)
LPWSTR GetCurrentCertSubjectRDN();

char* secureblackbox_certificatevalidator_getcurrentcertsubjectrdn(void* lpObj);

QString GetCurrentCertSubjectRDN();

Default Value

""

Remarks

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the certificate holder (subject).

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

Data Type

String

CurrentCertValidFrom Property (CertificateValidator Class)

The time point at which the certificate becomes valid, in UTC.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertValidFrom();

Unicode (Windows)
LPWSTR GetCurrentCertValidFrom();

char* secureblackbox_certificatevalidator_getcurrentcertvalidfrom(void* lpObj);

QString GetCurrentCertValidFrom();

Default Value

""

Remarks

The time point at which the certificate becomes valid, in UTC.

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

Data Type

String

CurrentCertValidTo Property (CertificateValidator Class)

The time point at which the certificate expires, in UTC.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCurrentCertValidTo();

Unicode (Windows)
LPWSTR GetCurrentCertValidTo();

char* secureblackbox_certificatevalidator_getcurrentcertvalidto(void* lpObj);

QString GetCurrentCertValidTo();

Default Value

""

Remarks

The time point at which the certificate expires, in UTC.

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

Data Type

String

FIPSMode Property (CertificateValidator Class)

Reserved.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetFIPSMode();
int SetFIPSMode(int bFIPSMode);

Unicode (Windows)
BOOL GetFIPSMode();
INT SetFIPSMode(BOOL bFIPSMode);

int secureblackbox_certificatevalidator_getfipsmode(void* lpObj);
int secureblackbox_certificatevalidator_setfipsmode(void* lpObj, int bFIPSMode);

bool GetFIPSMode();
int SetFIPSMode(bool bFIPSMode);

Default Value

FALSE

Remarks

This property is reserved for future use.

Data Type

Boolean

GracePeriod Property (CertificateValidator Class)

Specifies a grace period to apply during certificate validation.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetGracePeriod();
int SetGracePeriod(int iGracePeriod);

Unicode (Windows)
INT GetGracePeriod();
INT SetGracePeriod(INT iGracePeriod);

int secureblackbox_certificatevalidator_getgraceperiod(void* lpObj);
int secureblackbox_certificatevalidator_setgraceperiod(void* lpObj, int iGracePeriod);

int GetGracePeriod();
int SetGracePeriod(int iGracePeriod);

Default Value

0

Remarks

Use this property to specify a grace period (in seconds). Grace period applies to certain subprotocols, such as OCSP, and caters to the inaccuracy and/or missynchronization of clocks on different participating systems. Any time deviations within the grace period will be tolerated.

Data Type

Integer

InterimValidationDetails Property (CertificateValidator Class)

Contains the validation details of the moment.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetInterimValidationDetails();
int SetInterimValidationDetails(int iInterimValidationDetails);

Unicode (Windows)
INT GetInterimValidationDetails();
INT SetInterimValidationDetails(INT iInterimValidationDetails);

int secureblackbox_certificatevalidator_getinterimvalidationdetails(void* lpObj);
int secureblackbox_certificatevalidator_setinterimvalidationdetails(void* lpObj, int iInterimValidationDetails);

int GetInterimValidationDetails();
int SetInterimValidationDetails(int iInterimValidationDetails);

Default Value

0

Remarks

Over the course of the validation process, the validator maintains an interim validity status for the chain that is being processed. This status is influenced by every single step of the validation routine, and may change along the way, before the end of the chain is reached and the final validation conclusion is drawn.

Use this property to check the interim validity details mid-flight.

The value of this property is a bit mask of the following options:

This property is not available at design time.

Data Type

Integer

InterimValidationResult Property (CertificateValidator Class)

Contains the validation status of the moment.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetInterimValidationResult();
int SetInterimValidationResult(int iInterimValidationResult);

Unicode (Windows)
INT GetInterimValidationResult();
INT SetInterimValidationResult(INT iInterimValidationResult);

CVT_VALID(0), 
CVT_VALID_BUT_UNTRUSTED(1), 
CVT_INVALID(2), 
CVT_CANT_BE_ESTABLISHED(3)

int secureblackbox_certificatevalidator_getinterimvalidationresult(void* lpObj);
int secureblackbox_certificatevalidator_setinterimvalidationresult(void* lpObj, int iInterimValidationResult);

int GetInterimValidationResult();
int SetInterimValidationResult(int iInterimValidationResult);

Default Value

0

Remarks

Over the course of the validation process, the validator maintains an interim validity status for the chain that is being processed. This status is influenced by every single step of the validation routine, and may change along the way, before the end of the chain is reached and the final validation conclusion is drawn.

Use this property to check the interim validity status mid-flight.

This property is not available at design time.

Data Type

Integer

KnownCertCount Property (CertificateValidator Class)

The number of records in the KnownCert arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKnownCertCount();
int SetKnownCertCount(int iKnownCertCount);

Unicode (Windows)
INT GetKnownCertCount();
INT SetKnownCertCount(INT iKnownCertCount);

int secureblackbox_certificatevalidator_getknowncertcount(void* lpObj);
int secureblackbox_certificatevalidator_setknowncertcount(void* lpObj, int iKnownCertCount);

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

Default Value

0

Remarks

This property controls the size of the following arrays:

• KnownCertBytes
• KnownCertHandle

The array indices start at 0 and end at KnownCertCount - 1.

This property is not available at design time.

Data Type

Integer

KnownCertBytes Property (CertificateValidator Class)

Returns raw certificate data in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKnownCertBytes(int iKnownCertIndex, char* &lpKnownCertBytes, int &lenKnownCertBytes);

Unicode (Windows)
INT GetKnownCertBytes(INT iKnownCertIndex, LPSTR &lpKnownCertBytes, INT &lenKnownCertBytes);

int secureblackbox_certificatevalidator_getknowncertbytes(void* lpObj, int knowncertindex, char** lpKnownCertBytes, int* lenKnownCertBytes);

QByteArray GetKnownCertBytes(int iKnownCertIndex);

Remarks

Returns raw certificate data in DER format.

The KnownCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCertCount property.

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

Data Type

Byte Array

KnownCertHandle Property (CertificateValidator Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetKnownCertHandle(int iKnownCertIndex);
int SetKnownCertHandle(int iKnownCertIndex, int64 lKnownCertHandle);

Unicode (Windows)
LONG64 GetKnownCertHandle(INT iKnownCertIndex);
INT SetKnownCertHandle(INT iKnownCertIndex, LONG64 lKnownCertHandle);

int64 secureblackbox_certificatevalidator_getknowncerthandle(void* lpObj, int knowncertindex);
int secureblackbox_certificatevalidator_setknowncerthandle(void* lpObj, int knowncertindex, int64 lKnownCertHandle);

qint64 GetKnownCertHandle(int iKnownCertIndex);
int SetKnownCertHandle(int iKnownCertIndex, qint64 lKnownCertHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The KnownCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCertCount property.

This property is not available at design time.

Data Type

Long64

KnownCRLCount Property (CertificateValidator Class)

The number of records in the KnownCRL arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKnownCRLCount();
int SetKnownCRLCount(int iKnownCRLCount);

Unicode (Windows)
INT GetKnownCRLCount();
INT SetKnownCRLCount(INT iKnownCRLCount);

int secureblackbox_certificatevalidator_getknowncrlcount(void* lpObj);
int secureblackbox_certificatevalidator_setknowncrlcount(void* lpObj, int iKnownCRLCount);

int GetKnownCRLCount();
int SetKnownCRLCount(int iKnownCRLCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• KnownCRLBytes
• KnownCRLHandle

The array indices start at 0 and end at KnownCRLCount - 1.

This property is not available at design time.

Data Type

Integer

KnownCRLBytes Property (CertificateValidator Class)

Returns raw CRL data in DER format.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKnownCRLBytes(int iKnownCRLIndex, char* &lpKnownCRLBytes, int &lenKnownCRLBytes);

Unicode (Windows)
INT GetKnownCRLBytes(INT iKnownCRLIndex, LPSTR &lpKnownCRLBytes, INT &lenKnownCRLBytes);

int secureblackbox_certificatevalidator_getknowncrlbytes(void* lpObj, int knowncrlindex, char** lpKnownCRLBytes, int* lenKnownCRLBytes);

QByteArray GetKnownCRLBytes(int iKnownCRLIndex);

Remarks

Returns raw CRL data in DER format.

The KnownCRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCRLCount property.

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

Data Type

Byte Array

KnownCRLHandle Property (CertificateValidator Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetKnownCRLHandle(int iKnownCRLIndex);
int SetKnownCRLHandle(int iKnownCRLIndex, int64 lKnownCRLHandle);

Unicode (Windows)
LONG64 GetKnownCRLHandle(INT iKnownCRLIndex);
INT SetKnownCRLHandle(INT iKnownCRLIndex, LONG64 lKnownCRLHandle);

int64 secureblackbox_certificatevalidator_getknowncrlhandle(void* lpObj, int knowncrlindex);
int secureblackbox_certificatevalidator_setknowncrlhandle(void* lpObj, int knowncrlindex, int64 lKnownCRLHandle);

qint64 GetKnownCRLHandle(int iKnownCRLIndex);
int SetKnownCRLHandle(int iKnownCRLIndex, qint64 lKnownCRLHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The KnownCRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCRLCount property.

This property is not available at design time.

Data Type

Long64

KnownOCSPCount Property (CertificateValidator Class)

The number of records in the KnownOCSP arrays.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKnownOCSPCount();
int SetKnownOCSPCount(int iKnownOCSPCount);

Unicode (Windows)
INT GetKnownOCSPCount();
INT SetKnownOCSPCount(INT iKnownOCSPCount);

int secureblackbox_certificatevalidator_getknownocspcount(void* lpObj);
int secureblackbox_certificatevalidator_setknownocspcount(void* lpObj, int iKnownOCSPCount);

int GetKnownOCSPCount();
int SetKnownOCSPCount(int iKnownOCSPCount);

Default Value

0

Remarks

This property controls the size of the following arrays:

• KnownOCSPBytes
• KnownOCSPHandle

The array indices start at 0 and end at KnownOCSPCount - 1.

This property is not available at design time.

Data Type

Integer

KnownOCSPBytes Property (CertificateValidator Class)

Buffer containing raw OCSP response data.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetKnownOCSPBytes(int iKnownOCSPIndex, char* &lpKnownOCSPBytes, int &lenKnownOCSPBytes);

Unicode (Windows)
INT GetKnownOCSPBytes(INT iKnownOCSPIndex, LPSTR &lpKnownOCSPBytes, INT &lenKnownOCSPBytes);

int secureblackbox_certificatevalidator_getknownocspbytes(void* lpObj, int knownocspindex, char** lpKnownOCSPBytes, int* lenKnownOCSPBytes);

QByteArray GetKnownOCSPBytes(int iKnownOCSPIndex);

Remarks

Buffer containing raw OCSP response data.

The KnownOCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownOCSPCount property.

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

Data Type

Byte Array

KnownOCSPHandle Property (CertificateValidator Class)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int64 GetKnownOCSPHandle(int iKnownOCSPIndex);
int SetKnownOCSPHandle(int iKnownOCSPIndex, int64 lKnownOCSPHandle);

Unicode (Windows)
LONG64 GetKnownOCSPHandle(INT iKnownOCSPIndex);
INT SetKnownOCSPHandle(INT iKnownOCSPIndex, LONG64 lKnownOCSPHandle);

int64 secureblackbox_certificatevalidator_getknownocsphandle(void* lpObj, int knownocspindex);
int secureblackbox_certificatevalidator_setknownocsphandle(void* lpObj, int knownocspindex, int64 lKnownOCSPHandle);

qint64 GetKnownOCSPHandle(int iKnownOCSPIndex);
int SetKnownOCSPHandle(int iKnownOCSPIndex, qint64 lKnownOCSPHandle);

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The KnownOCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownOCSPCount property.

This property is not available at design time.

Data Type

Long64

MaxValidationTime Property (CertificateValidator Class)

Specifies the maximum time the validation process may take.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetMaxValidationTime();
int SetMaxValidationTime(int iMaxValidationTime);

Unicode (Windows)
INT GetMaxValidationTime();
INT SetMaxValidationTime(INT iMaxValidationTime);

int secureblackbox_certificatevalidator_getmaxvalidationtime(void* lpObj);
int secureblackbox_certificatevalidator_setmaxvalidationtime(void* lpObj, int iMaxValidationTime);

int GetMaxValidationTime();
int SetMaxValidationTime(int iMaxValidationTime);

Default Value

0

Remarks

Use this property to limit the amount of time available for the validator to carry out the validation. If the validation process exceeds this time, it is terminated and the validation error is returned.

Data Type

Integer

OfflineMode Property (CertificateValidator Class)