:SetDeliveryOptions()


Class

     aprSMTP()

 

Syntax

     :SetDeliveryOptions() -> lSuccess

 

Parameters

 

nOptions

Numeric. See table below for more information

 

hSession

Optional: If hSession is not passed, the value in :Session will be used

 

Return

Logical indicating Success.

Returns .T. if the operation succeeds, otherwise returns .F.

 

To get more information about the error, see :nErr and :cErr.

To get the server's response, see :GetResultCode() and :GetResultString().

 

Description

The :SetDeliveryOptions() method sets the current delivery options for the client session.

 

Note that delivery options are only available on those mail servers which support delivery status notification (DSN) using the extended SMTP protocol. The client must identify itself using the :HelloEx() method in order to use extended server options.

 

Delivery Options are created by combining one or more of the following constants :

SMTP_NOTIFY_NEVER

Never return information about the success or failure of the message delivery process.

SMTP_NOTIFY_SUCCESS

Return a message to the sender if the message has been successfully delivered to the recipient's mail server.

SMTP_NOTIFY_FAILURE

Return a message to the sender if the message could not be delivered to the recipient's mail server.

SMTP_NOTIFY_DELAY

Return a message to the sender if delivery of the message was delayed.

SMTP_RETURN_HEADERS

Return only the message headers to the sender.

SMTP_RETURN_MESSAGE

Return the complete message headers and body to the sender.

 

See Also

:GetDeliveryOptions(), :GetExtendedOptioins(), :HelloEx()