4D Doc Center : SMTP

4D v13.2

SMTP_ReplyTo


SMTP_ReplyTo ( smtp_ID ; replyTo ; deleteOption ) -> Function result

Parameter	Type	Description
smtp_ID	Longint	Message reference
replyTo	Text	MailAddress or AddressList
deleteOption	Integer	0 = Add to existing list, 1 = Replace old values with the new values, 2 = Remove the specified addresses
Function result	Integer	Error Code

Description

The SMTP_ReplyTo command provides the user with the ability to control the direction of replies made to the message. Normally, all replies to a message come back to the people it was "From". By setting the "ReplyTo" header on outgoing mail you can affect the default routing of responses to the message.

For the database developer, SMTP_ReplyTo can be very powerful tool permitting them to control the behavior of replies to automated mail. Users may want replies sent to addresses other than those listed in the From or Sender addresses, such as a separate account created to track responses.

smtp_ID is the long integer reference to the mail message created with the SMTP_New command

replyTo is a text value containing an AddressList of one or more mail addresses. The addresses listed in this field will be used by the recipient's mail software as the default mail-account to direct their replies.

deleteOption is an integer value which specifies how to handle the address(es) listed in replyTo. A value of zero will add the new values to any previously assigned to this header. A value of 1 will replace any prior definitions with the new values. If replyTo is a null string, all prior values will be removed and the header deleted from the message. A value of 2 will delete the specified addresses from any previously assigned values. deleteOption is an optional parameter which will default to zero if not otherwise specified.

Example

In this example, 3 executives compose a message on the subject of a company policy change that is then distributed by the secretary to everyone in the company. Any responses to this message would be redirected to the secretary and "personnel_dept" and would not be seen by the executives.

 $From:="prez@acme.com, vp@acme.com, cfo@acme.com"

 $Error:=SMTP_From($smtp_id;$From;0)

 $Error:=SMTP_Sender($smtp_id;"secretary@acme.com";0)

 $Error:=SMTP_ReplyTo($smtp_id;"secretary@acme.com, personnel_dept@acme.com";0)

 $Error:=SMTP_Subject($smtp_id;"Company Policy Change";0)

 $Error:=SMTP_To($smtp_id;◊AllEmployee;0)