TElX509CertificateValidator.OnBeforeCRLRetrieverUse event

TElX509CertificateValidator.OnBeforeCRLRetrieverUse

This event is fired before CRL retriever is used.

Declaration

[C#]
event TSBBeforeCRLRetrieverUseEvent OnBeforeCRLRetrieverUse;
delegate void TSBBeforeCRLRetrieverUseEvent(Object Sender, TElX509Certificate Certificate, TElX509Certificate CACertificate, TSBGeneralName NameType, string Location, ref TElCustomCRLRetriever Retriever);

[VB.NET]
Event OnBeforeCRLRetrieverUse As TSBBeforeCRLRetrieverUseEvent
Delegate Sub TSBBeforeCRLRetrieverUseEvent(ByVal Sender As Object, ByVal Certificate As TElX509Certificate, ByVal CACertificate As TElX509Certificate, ByVal NameType As TSBGeneralName, ByVal Location As String, ByRef Retriever As TElCustomCRLRetriever)

[Pascal]
property OnBeforeCRLRetrieverUse : TSBBeforeCRLRetrieverUseEvent;
TSBBeforeCRLRetrieverUseEvent = procedure (Sender: TObject; Certificate, CACertificate : TElX509Certificate; NameType : TSBGeneralName; const Location : string; var Retriever : TElCustomCRLRetriever) of object;

[C++]
    void get_OnBeforeCRLRetrieverUse(TSBBeforeCRLRetrieverUseEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnBeforeCRLRetrieverUse(TSBBeforeCRLRetrieverUseEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TSBBeforeCRLRetrieverUseEvent)(void * _ObjectData, TObjectHandle Sender, TElX509CertificateHandle Certificate, TElX509CertificateHandle CACertificate, TSBGeneralNameRaw NameType, const char * pcLocation, int32_t szLocation, TElCustomCRLRetrieverHandle &Retriever);

[PHP]
    TSBBeforeCRLRetrieverUseEvent|callable|NULL get_OnBeforeCRLRetrieverUse()
    void set_OnBeforeCRLRetrieverUse(TSBBeforeCRLRetrieverUseEvent|callable|NULL $Value)
    callable TSBBeforeCRLRetrieverUseEvent(TObject $Sender, TElX509Certificate $Certificate, TElX509Certificate $CACertificate, integer $NameType, string $Location, TElCustomCRLRetriever &$Retriever)

[Java]
    TSBBeforeCRLRetrieverUseEvent getOnBeforeCRLRetrieverUse();
    void setOnBeforeCRLRetrieverUse(TSBBeforeCRLRetrieverUseEvent Value);
    TSBBeforeCRLRetrieverUseEvent.Callback OnBeforeCRLRetrieverUse = new TSBBeforeCRLRetrieverUseEvent.Callback() {
        public TElCustomCRLRetriever TSBBeforeCRLRetrieverUseEventCallback(TObject Sender, TElX509Certificate Certificate, TElX509Certificate CACertificate, TSBGeneralName NameType, String Location, TElCustomCRLRetriever Retriever) {
            //...
        }
    }

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 to be retrieved
Retriever - An instance of TElCustomCRLRetriever class or its descendant. Can be empty, or can be replaced by some other instance.
pcLocation - Location of the CRL to be 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.