ElCustomCertStorage.Validate method

Navigation

View Table Of Contents | Send comments on this topic

ElCustomCertStorage.Validate

Validate given certificate

Declaration

[C#]
TSBCertificateValidity Validate(ElX509Certificate Certificate, ref TSBCertificateValidityReason Reason, DateTime ValidityMoment /*= 0*/);
TSBCertificateValidity Validate(ElX509Certificate Certificate, ref TSBCertificateValidityReason Reason, bool CheckCACertDates, DateTime ValidityMoment /*= 0*/);

[VB.NET]
Function Validate(ByVal Certificate As ElX509Certificate, ByRef Reason As TSBCertificateValidityReason, ByVal ValidityMoment As DateTime) As TSBCertificateValidity
Function Validate(ByVal Certificate As ElX509Certificate, ByRef Reason As TSBCertificateValidityReason, ByVal CheckCACertDates As Boolean, ByVal ValidityMoment As DateTime) As TSBCertificateValidity

[Pascal]
function Validate(Certificate : TElX509Certificate; var Reason : TSBCertificateValidityReason; ValidityMoment : TDateTime = 0) : TSBCertificateValidity;
function Validate(Certificate : TElX509Certificate; var Reason : TSBCertificateValidityReason; CheckCACertDates : boolean; ValidityMoment : TDateTime = 0) : TSBCertificateValidity;

[VB6]
Sub IElCustomCertStorageX.Validate(Certificate As IElCertificateX, Validity As TxSBCertificateValidity, Reason As TxSBCertificateValidityReason)

[ActiveX]
HRESULT _stdcall IElCustomCertStorageX.Validate([in] IElCertificateX * Certificate, [out] TxSBCertificateValidity * Validity, [out] TxSBCertificateValidityReason * Reason);

[DLL]
not applicable;

Parameters

Certificate - Certificate object, initialized by LoadFromBuffer method
Validity - (out) certificate validity
Reason - (out) certificate validity parameters.
ValidityMoment - Time to check validity period against. Default value of 0 means "check current moment"
CheckCACertDates - When this parameter is False, time specified in ValidityMoment is checked against validity period of the certificate being validated only.
When CheckCACertDates is True, validity periods of all certificates in the chain are questioned.
Default value is False.

Values

[.NET] [Pascal] [ActiveX] [DLL] Description

1 vrBadData SB_CERT_VALIDITY_REASON_BAD_DATA = 1 Invalid certificate format or certificate is corrupted

2 vrRevoked SB_CERT_VALIDITY_REASON_REVOKED = 2 Certificate is revoked by Issuer

4 vrNotYetValid SB_CERT_VALIDITY_REASON_NOT_YET_VALID = 4 Certificate is not valid yet

8 vrExpired SB_CERT_VALIDITY_REASON_EXPIRED = 8 Certificate is expired

16 vrInvalidSignature SB_CERT_VALIDITY_REASON_INVALID_SIGNATURE = 16 Certificate contains invalid digital signature, it could be corrupted

32 vrUnknownCA SB_CERT_VALIDITY_REASON_UNKNOWN_CA = 32 The Issuer's certificate not found, so certificate validation is not possible.

Declared in

[.NET] [Pascal]

Namespace: SBX509
Assembly: SecureBlackbox Unit: SBX509

Return value

[.NET] [Pascal] [ActiveX] [DLL] Description

cvOk = 0 cvOk SB_CERT_VALIDITY_OK = 1 certificate was validated successfully and is valid

cvSelfSigned = 1 cvSelfSigned SB_CERT_VALIDITY_SELF_SIGNED = 2 certificate is self signed

cvInvalid = 2 cvInvalid SB_CERT_VALIDITY_INVALID = 4 certificate is invalid

cvStorageError = 3 cvStorageError SB_CERT_VALIDITY_STORAGE_ERROR = 8 certificate was not validated due to certificate storage error

Declared in

[.NET] [Pascal]

Namespace: SBX509
Assembly: SecureBlackbox Unit: SBX509

Description

This method uses CRL property for certificate validation when this property is specified.
Do not use this method directly. Use the same method of the derived classes ElWinCertStorage, ElMemoryCertStorage and ElFileCertStorage .