EldoS
Navigation
Web site
Support
Table Of Contents

Filter: C#  VB.NET  Pascal  ActiveX  DLL 


TElSecureClient.OnCertificateNeededEx

TElSecureClient     See also    


 

This event is fired when the protocol requires a client certificate. This event obsoletes the OnCertificateNeeded event. Please avoid using the OnCertificateNeeded event in your applications, as OnCertificateNeededEx event gives much more flexibility.

 
 

Declaration

[C#]
    event TSBCertificateNeededExEvent OnCertificateNeededEx;
    delegate void TSBCertificateNeededExEvent(object Sender, ref TElX509Certificate Certificate)

[VB.NET]
    Event OnCertificateNeededEx As TSBCertificateNeededExEvent
    Delegate Sub TSBCertificateNeededExEvent(ByVal Sender As Object, ByRef Certificate As TElX509Certificate)

[Pascal]
    property OnCertificateNeededEx : TSBCertificateNeededExEvent;
    TSBCertificateNeededExEvent = procedure (Sender: TObject; var Certificate : TElX509Certificate) of object;

[VB6]
    Event IElSecureClientXEvents.OnCertificateNeededEx(Cert As IElCertificateX)

[ActiveX]
    HRESULT IElSecureClientXEvents.OnCertificateNeededEx([out] IElCertificateX ** Cert);

[DLL]
    TOnCertificateNeededExEventHandler = procedure(Handle : THandle; UserData : integer; var CertHandle : THandle); stdcall;
 
 

Parameters

  • [DLL]handle - handle to the TElSecureClient object that was returned by Constructor
  • [DLL]CertHandle - handle to the X509Certificate object that was returned by Constructor
  • [DLL]UserData - application-defined data that is passed back to the callback function
  • Certificate (Cert) - points to instance of TElX509Certificate class (see noted below)
 
 

Description

    This event is fired by TElSecureClient when the negotiated protocol requires a client-side X509 certificate to be used during the session. TElSecureClient fires OnCertificateNeededEx event consequently, until the nil/NULL value is passed as Certificate parameter. This gives the ability to pass a certificate chain to the server, not only a single certificate. This event should be handled in the following way:

  • Pass the whole certificate chain, beginning at end-entity certificate with a corresponding private key.
  • When the chain is over, pass nil/NULL as Certificate parameter.

OnCertificateNeededEx can accept the certificate which belongs to the certain chain. In this case the whole chain is sent and OnCertificateNeededEx is not fired further.

An alternative to this event is to use ClientCertStorage property.

 
 

See also:     OnCertificateValidate     ClientCertStorage    

 
Contact Us | Terms of Use | Trademarks | Privacy Statement
Copyright (c) 1998-2012, EldoS Corporation