4D Doc Center : SMTP

4D v13.2

SMTP_Subject


SMTP_Subject ( smtp_ID ; subject ; deleteOption ) -> Function result

Parameter	Type	Description
smtp_ID	Longint	Message reference
subject	Text	Subject of message
deleteOption	Integer	0 = Replace (if subject not empty), 1 = Replace, 2 = Delete
Function result	Integer	Error Code

Description

The SMTP_Subject command adds the subject of the message to the message referenced by smtp_ID. If a subject has already been added by a previous SMTP_Subject command, the new subject will override the previous subject.

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

subject is a text value concisely describing the topic covered in detail by the message body.

Warning: Usually, the subject of the message should not contain characters with diacritical marks (such as é, ö, etc.). However, if you want to use such “extended” characters, refer to the SMTP_SetPrefs and SMTP_Charset command descriptions.

Warning: The text should not contain a line feed (ascii=10). Doing so would signify the end of the header section and the beginning of the body. Subsequent header items could be pushed into the body and not recognized properly by the server or client software. For more information regarding the headers, please refer to RFC#822.

deleteOption is an integer value which specifies whether to replace or delete the "Subject" header:

A value of zero will set the "Subject" field to the new value, overriding any prior settings (if you pass an empty string in subject, the prior header will be used).
A value of 1 will set the "Subject" field to the new value, overriding any prior settings (if you pass an empty string in subject, the header will be deleted).
A value of 2 will remove the "Subject" field from the mail envelope.
deleteOption is an optional parameter which will default to zero if not otherwise specified.

Example

See the example for the command SMTP_Body.