TElPDFAdvancedPublicKeySecurityHandler.OnCertValidatorFinished event

TElPDFAdvancedPublicKeySecurityHandler.OnCertValidatorFinished

TElPDFAdvancedPublicKeySecurityHandler See also

This event is fired after a certificate has been validated.

Declaration

[C#]
event TSBPDFCertValidatorFinishedEvent OnCertValidatorFinished;
delegate void TSBPDFCertValidatorFinishedEvent(Object Sender, TElX509CertificateValidator CertValidator, TElX509Certificate Cert, TSBCertificateValidity Validity, TSBCertificateValidityReason Reason);

[VB.NET]
Event OnCertValidatorFinished As TSBPDFCertValidatorFinishedEvent
Delegate Sub TSBPDFCertValidatorFinishedEvent(ByVal Sender As Object, ByVal CertValidator As TElX509CertificateValidator, ByVal Cert As TElX509Certificate, ByVal Validity As TSBCertificateValidity, ByVal Reason As TSBCertificateValidityReason)

[Pascal]
property OnCertValidatorFinished : TSBPDFCertValidatorFinishedEvent;
TSBPDFCertValidatorFinishedEvent = procedure(Sender : TObject; CertValidator : TElX509CertificateValidator; Cert : TElX509Certificate; Validity : TSBCertificateValidity; Reason : TSBCertificateValidityReason) of object;

[C++]
    void get_OnCertValidatorFinished(TSBPDFCertValidatorFinishedEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnCertValidatorFinished(TSBPDFCertValidatorFinishedEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TSBPDFCertValidatorFinishedEvent)(void * _ObjectData, TObjectHandle Sender, TElX509CertificateValidatorHandle CertValidator, TElX509CertificateHandle Cert, TSBCertificateValidityRaw Validity, TSBCertificateValidityReasonRaw Reason);

[PHP]
    TSBPDFCertValidatorFinishedEvent|callable|NULL get_OnCertValidatorFinished()
    void set_OnCertValidatorFinished(TSBPDFCertValidatorFinishedEvent|callable|NULL $Value)
    callable TSBPDFCertValidatorFinishedEvent(TObject $Sender, TElX509CertificateValidator $CertValidator, TElX509Certificate $Cert, integer $Validity, integer $Reason)

[Java]
    TSBPDFCertValidatorFinishedEvent getOnCertValidatorFinished();
    void setOnCertValidatorFinished(TSBPDFCertValidatorFinishedEvent Value);
    TSBPDFCertValidatorFinishedEvent.Callback OnCertValidatorFinished = new TSBPDFCertValidatorFinishedEvent.Callback() {
        public void TSBPDFCertValidatorFinishedEventCallback(TObject Sender, TElX509CertificateValidator CertValidator, TElX509Certificate Cert, TSBCertificateValidity Validity, int Reason) {
            //...
        }
    }

Parameters

Cert - the certificate that has been validated
CertValidator - TElX509CertificateValidator object that has been used for validation
Validity - contains validation result
Reason - contains (in)validity reason

Possible validity values:

[.NET] [C++]	[Pascal]	Description
cvOk = 0	cvOk	Certificate was validated successfully and is valid
cvSelfSigned = 1	cvSelfSigned	Certificate is self signed
cvInvalid = 2	cvInvalid	Certificate is invalid
cvStorageError = 3	cvStorageError	Certificate was not validated due to certificate storage error
cvChainUnvalidated = 4	cvChainUnvalidated	Certificate chain was not validated because while the certificate itself is valid, one or more of CA Certificates in the chain have validation problems

Possible validity reason values:

[.NET]	[Pascal]	[C++]	Description
vrBadData = 1	vrBadData	f_vrBadData = 1	Invalid certificate format or certificate is corrupted
vrRevoked = 2	vrRevoked	f_vrRevoked = 2	Certificate is revoked by Issuer
vrNotYetValid = 4	vrNotYetValid	f_vrNotYetValid = 4	Certificate is not valid yet
vrExpired = 8	vrExpired	f_vrExpired = 8	Certificate is expired
vrInvalidSignature = 16	vrInvalidSignature	f_vrInvalidSignature = 16	Certificate contains invalid digital signature, it could be corrupted
vrUnknownCA = 32	vrUnknownCA	f_vrUnknownCA = 32	Issuer (CA) certificate was not found.
vrCAUnauthorized = 64	vrCAUnauthorized	f_vrCAUnauthorized = 64	Issuer (CA) certificate was found but its key usage fields don't allow use of this certificate for signing other certificates.
vrCRLNotVerified = 128	vrCRLNotVerified	f_vrCRLNotVerified = 128	Certificate Revocation List for this certificate could not be retrieved and/or validated.
vrOCSPNotVerified = 256	vrOCSPNotVerified	f_vrOCSPNotVerified = 256	OCSP response for this certificate could not be retrieved and/or validated.
vrIdentityMismatch = 512	vrIdentityMismatch	f_vrIdentityMismatch = 512	Provided certificate doesn't include the specified name and / or IP address. Either the remote side in TLS or sender in S/MIME is misconfigured, or the certificate is misused by the remote side or sender, or authenticity of the remote side or sender is forged.
vrNoKeyUsage = 1024	vrNoKeyUsage	f_vrNoKeyUsage = 1024	Provided certificate may not be used for chosen activity (identifying TLS server or client or S/MIME message sender)
vrBlocked = 2048	vrBlocked	f_vrBlocked = 2048	Provided certificate has been found in the list of blocked certificates
vrFailure = 4096	vrFailure	f_vrFailure = 4096	Validation took too long, aborted
vrChainLoop = 8192	vrChainLoop	f_vrChainLoop = 8192	Certificate chain includes a loop. Further validation is not possible.
vrWeakAlgorithm = 16384	vrWeakAlgorithm	f_vrWeakAlgorithm = 16384	One of certificates is signed using the weak hash algorithm

Description

This event is fired by TElPDFAdvancedPublicKeySecurityHandler when validation of a certificate has been finished.