TElX509CertificateValidator.OnBeforeCertificateRetrieverUse event

TElX509CertificateValidator.OnBeforeCertificateRetrieverUse

This event is fired before retrieving a CA certificate.

Declaration

[C#]
event TSBBeforeCertificateRetrieverUseEvent OnBeforeCertificateRetrieverUse;
delegate void TSBBeforeCertificateRetrieverUseEvent(Object Sender, TElX509Certificate Certificate, TSBGeneralName NameType, string Location, ref TElCustomCertificateRetriever Retriever);

[VB.NET]
Event OnBeforeCertificateRetrieverUse As TSBBeforeCertificateRetrieverUseEvent
Delegate Sub TSBBeforeCertificateRetrieverUseEvent(ByVal Sender As Object, ByVal Certificate As TElX509Certificate, ByVal NameType As TSBGeneralName, ByVal Location As String, ByRef Retriever As TElCustomCertificateRetriever)

[Pascal]
property OnBeforeCertificateRetrieverUse : TSBBeforeCertificateRetrieverUseEvent;
TSBBeforeCertificateRetrieverUseEvent = procedure(Sender : TObject; Certificate : TElX509Certificate; NameType : TSBGeneralName; const Location : string; var Retriever : TElCustomCertificateRetriever) of object;

[C++]
    void get_OnBeforeCertificateRetrieverUse(TSBBeforeCertificateRetrieverUseEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnBeforeCertificateRetrieverUse(TSBBeforeCertificateRetrieverUseEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TSBBeforeCertificateRetrieverUseEvent)(void * _ObjectData, TObjectHandle Sender, TElX509CertificateHandle Certificate, TSBGeneralNameRaw NameType, const char * pcLocation, int32_t szLocation, TElCustomCertificateRetrieverHandle &Retriever);

[PHP]
    TSBBeforeCertificateRetrieverUseEvent|callable|NULL get_OnBeforeCertificateRetrieverUse()
    void set_OnBeforeCertificateRetrieverUse(TSBBeforeCertificateRetrieverUseEvent|callable|NULL $Value)
    callable TSBBeforeCertificateRetrieverUseEvent(TObject $Sender, TElX509Certificate $Certificate, integer $NameType, string $Location, TElCustomCertificateRetriever &$Retriever)

[Java]
    TSBBeforeCertificateRetrieverUseEvent getOnBeforeCertificateRetrieverUse();
    void setOnBeforeCertificateRetrieverUse(TSBBeforeCertificateRetrieverUseEvent Value);
    TSBBeforeCertificateRetrieverUseEvent.Callback OnBeforeCertificateRetrieverUse = new TSBBeforeCertificateRetrieverUseEvent.Callback() {
        public TElCustomCertificateRetriever TSBBeforeCertificateRetrieverUseEventCallback(TObject Sender, TElX509Certificate Certificate, TSBGeneralName NameType, String Location) {
            //...
        }
    }

Parameters

Certificate - the certificate for which the signing certificate is needed.
NameType - specifies the name type of the certificate location.
Location - specifies certificate location.
Retriever - the component to be used for certificate retrieval.
pcLocation - specifies certificate location.
szLocation - the length of pcLocation.

Name types:

[.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 by TElX509CertificateValidator when it needs the signing certificate. The user should provide TElCustomCertificateRetriever object which will be used to retrieve the certificate.