4D Doc Center : SMTP

Home

4D Internet Commands v14

SMTP_Cc


SMTP_Cc ( smtp_ID ; carbonCopy {; deleteOption} ) -> Function result

Parameter	Type	Description
smtp_ID	Longint	Message reference
carbonCopy	Text	MailAddress or AddressList
deleteOption	Integer	0 = Add, 1 = Replace, 2 = Delete
Function result	Integer	Error Code

Description

The SMTP_Cc command adds carbon copy recipients to the message specified by smtp_ID. It is not mandatory to have any addresses in the Cc: field. All addresses listed in the "To" and "cc" headers in a mail message are visible to each recipient of the message.

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

carbonCopy is a text value containing an AddressList of one or more mail addresses.

deleteOption is an integer value which specifies whether to add or delete the "Cc" header:

A value of zero will add the new value to the "Cc" field.
A value of 1 will set the "Cc" field to the new value, overriding any prior settings (if you pass an empty string in carbonCopy, the header will be removed from the mail envelope).
A value of 2 will delete any address previously defined for the "Cc" field and remove the header 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.