BCC Property

Topic Last Modified: 2006-12-01

The blind carbon copy (Bcc) recipients for this message.

Applies To

IMessage Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In

CDOEX.DLL

Syntax

Property BCC As String

HRESULT get_BCC(BSTR* pVal);HRESULT put_BCC(BSTR Val);

Parameters

  • pVal
    Returns the value of the BCC property as a reference to a BSTR.
  • Val
    Sets the value of the BCC property to the value of the BSTR.

Remarks

This property is also available as the urn:schemas:mailheader:bcc and urn:schemas:httpmail:bcc fields.

The string in the BCC property can represent a single recipient or multiple recipients. Each address in the list must be a full messaging address, for example,

"User" <UserAddress@example.com>;

where User is the friendly name and <UserAddress@example.com> is the actual e-mail address.

Commas separate multiple recipients in the list:

"User1" <User1@example.com>, "User2" <User2@example.com>, "User3" <User3@example.com>

Commas are not used as separators when enclosed in double quotation marks, such as:

"Dan K. Bacon, Jr." <dan@example.com>

The friendly name must include the quotation marks in the property; thus, when setting this property, you will need to use double quotation marks or other appropriate techniques to include them.

The following are examples of setting this property:

iMsg.To = " ""Dan K. Bacon, Jr."" <dan@example.com>, ""Brenda Diaz"" <brenda@example.com>"

in Microsoft® Visual Basic®, or

pMsg->put_To(_bstr_t("\"Dan K. Bacon, Jr.\" <dan@example.com>, \"Brenda Diaz\" <brenda@example.com>"));

in C++.

In keeping with the privacy intended by blind copies, BCC is regarded as an envelope property rather than a message property. Accordingly, the corresponding header field and its contents are removed when the message is delivered, and you should always expect the BCC property to be empty on a received message.

The default value of BCC is an empty string.

For information about how the bcc field is used in schemas, see urn:schemas:mailheader:bcc Field (bcc Field) and urn:schemas:httpmail:bcc Field (bcc Field).