TElX509CertificateValidator.OnCRLRetrieved event

TElX509CertificateValidator.OnCRLRetrieved

This event is fired before CRL retriever is used.

Declaration

[C#]
event TSBCRLRetrievedEvent OnCRLRetrieved;
delegate void TSBCRLRetrievedEvent(Object Sender, TElX509Certificate Certificate, TElX509Certificate CACertificate, TSBGeneralName NameType, string Location, TElCertificateRevocationList CRL);

[VB.NET]
Event OnCRLRetrieved As TSBCRLRetrievedEvent
Delegate Sub TSBCRLRetrievedEvent(ByVal Sender As Object, ByVal Certificate As TElX509Certificate, ByVal CACertificate As TElX509Certificate, ByVal NameType As TSBGeneralName, ByVal Location As String, ByVal CRL As TElCertificateRevocationList)

[Pascal]
property OnCRLRetrieved : TSBCRLRetrievedEvent;
TSBCRLRetrievedEvent = procedure (Sender: TObject; Certificate, CACertificate : TElX509Certificate; NameType : TSBGeneralName; const Location : string; CRL : TElCertificateRevocationList) of object;

[C++]
    void get_OnCRLRetrieved(TSBCRLRetrievedEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnCRLRetrieved(TSBCRLRetrievedEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TSBCRLRetrievedEvent)(void * _ObjectData, TObjectHandle Sender, TElX509CertificateHandle Certificate, TElX509CertificateHandle CACertificate, TSBGeneralNameRaw NameType, const char * pcLocation, int32_t szLocation, TElCertificateRevocationListHandle CRL);

[PHP]
    TSBCRLRetrievedEvent|callable|NULL get_OnCRLRetrieved()
    void set_OnCRLRetrieved(TSBCRLRetrievedEvent|callable|NULL $Value)
    callable TSBCRLRetrievedEvent(TObject $Sender, TElX509Certificate $Certificate, TElX509Certificate $CACertificate, integer $NameType, string $Location, TElCertificateRevocationList $CRL)

[Java]
    TSBCRLRetrievedEvent getOnCRLRetrieved();
    void setOnCRLRetrieved(TSBCRLRetrievedEvent Value);
    TSBCRLRetrievedEvent.Callback OnCRLRetrieved = new TSBCRLRetrievedEvent.Callback() {
        public void TSBCRLRetrievedEventCallback(TObject Sender, TElX509Certificate Certificate, TElX509Certificate CACertificate, TSBGeneralName NameType, String Location, TElCertificateRevocationList CRL) {
            //...
        }
    }

Parameters

Certificate - Specifies the certificate that is being validated
CACertificate - Specifies the certificate, which signed Certificate.
Can be nil / null / Nothing, if Certificate is self-signed
NameType - specifies type of the name which identifies CRL location. Currently only gnUniformResourceIdentifier is supported
Location - Location of the CRL that was retrieved
CRL - The CRL which has been retrieved from the CRL location
pcLocation - Location of the CRL that was retrieved
szLocation - the length of pcLocation.

Possible NameType values:

[.NET] [C++]	[Pascal]	Description
gnRFC822Name = 0	gnRFC822Name	The content of TElGeneralName is an e-mail address and it is stored in TElGeneralName.RFC822Name
gnDNSName = 1	gnDNSName	The content of TElGeneralName is Domain Name Service label and it is stored in TElGeneralName.DNSName
gnDirectoryName = 2	gnDirectoryName	The content of TElGeneralName is stored in TElGeneralName.DirectoryName
gnEdiPartyName = 3	gnEdiPartyName	The content of TElGeneralName is EDI party name and it is stored in TElGeneralName.EdiPartyName
gnUniformResourceIdentifier = 4	gnUniformResourceIdentifier	The content of TElGeneralName is the URI of identity and it is stored in TElGeneralName.UniformResourceIdentifier
gnIPAddress = 5	gnIPAddress	The content of TElGeneralName is the IP address and it is stored in TElGeneralName.IpAddress
gnRegisteredID = 6	gnRegisteredID	The content of TElGeneralName is the registered Object Identifier and it is stored in TElGeneralName.RegidteredID
gnOtherName = 7	gnOtherName	The content of TElGeneralName is stored in TElGeneralName.OtherName
gnUnknown = 8	gnUnknown	name type is unknown
gnPermanentIdentifier = 9	gnPermanentIdentifier	Permanent Identifier (RFC 4043).

Description

This event is fired when the CRL is to be retrieved. If you need, you can adjust the instance of TElCustomCRLRetriever class, which will be used to retrieve the CRL. If there's no instance available (Retriever parameter is nil / null / Nothing), you should create such instance and pass it via Retriever parameter. See description of TElX509CertificateValidator component for additional information about default HTTP CRL retriever.

Discuss this help topic in SecureBlackbox Forum