TElSMTPClient.OnDSNEnvIDGenerate event

TElSMTPClient.OnDSNEnvIDGenerate

This event is fired when DSN ENVID value is needed.

Declaration

[C#]
event TSBSMTPDSNEnvIDGenerateEvent OnDSNEnvIDGenerate;
delegate void TSBSMTPDSNEnvIDGenerateEvent(Object Sender, TElStringList RcptTo, ref string EnvID);

[VB.NET]
Event OnDSNEnvIDGenerate As TSBSMTPDSNEnvIDGenerateEvent
Delegate Sub TSBSMTPDSNEnvIDGenerateEvent(ByVal Sender As Object, ByVal RcptTo As TElStringList, ByRef EnvID As String)

[Pascal]
property OnDSNEnvIDGenerate: TSBSMTPDSNEnvIDGenerateEvent;
TSBSMTPDSNOptionsEvent = procedure(Sender: TObject; const RcptTo: string; var EnvID : string) of object;

[C++]
    void get_OnDSNEnvIDGenerate(TSBSMTPDSNEnvIDGenerateEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnDSNEnvIDGenerate(TSBSMTPDSNEnvIDGenerateEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TSBSMTPDSNEnvIDGenerateEvent)(void * _ObjectData, TObjectHandle Sender, TElStringListHandle RcptTo, char * pcEnvID, int32_t &szEnvID);

[PHP]
    TSBSMTPDSNEnvIDGenerateEvent|callable|NULL get_OnDSNEnvIDGenerate()
    void set_OnDSNEnvIDGenerate(TSBSMTPDSNEnvIDGenerateEvent|callable|NULL $Value)
    callable TSBSMTPDSNEnvIDGenerateEvent(TObject $Sender, TElStringList $RcptTo, string &$EnvID)

[Java]
    TSBSMTPDSNEnvIDGenerateEvent getOnDSNEnvIDGenerate();
    void setOnDSNEnvIDGenerate(TSBSMTPDSNEnvIDGenerateEvent Value);
    TSBSMTPDSNEnvIDGenerateEvent.Callback OnDSNEnvIDGenerate = new TSBSMTPDSNEnvIDGenerateEvent.Callback() {
        public void TSBSMTPDSNEnvIDGenerateEventCallback(TObject Sender, TElStringList RcptTo, TSBString EnvID) {
            //...
        }
    }

Parameters

RcptTo - specifies the recepient.
EnvID - the handler shall provide the value of the ENVID keyword (identifier of the message transmission envelope) using this parameter.
pcEnvID - the handler shall provide the value of the ENVID keyword (identifier of the message transmission envelope) using this parameter.
szEnvID - the length of pcEnvID.

TSBSMTPDSNOption values:

[.NET]	[Pascal]	[C++]	Description
sdnSuccess = 1	sdnSuccess	f_sdnSuccess = 1	Delivery success.
sdnFailure = 2	sdnFailure	f_sdnFailure = 2	Delivery failure.
sdnDelay = 4	sdnDelay	f_sdnDelay = 4	Delivery delayed.

Description

The handler should generate the requested value and provide it to the client via the corresponding parameter.

Discuss this help topic in SecureBlackbox Forum