SMTP_ReplyTo

version 6.5

SMTP_ReplyTo (smtp_ID; replyTo{; deleteOption}) Integer

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.

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)

SMTP_New.