4D Internet Commands v14

SMTP_ReplyTo

Home

 
4D Internet Commands v14
SMTP_ReplyTo

SMTP_ReplyTo 


 

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

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)

 
PROPERTIES 

Product: 4D Internet Commands
Theme: IC Send Mail
Number: 88984

 
HISTORY 

Created: 4D Internet Commands 6.5

 
SEE ALSO 

SMTP_New

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)