BCC Property
Topic Last Modified: 2006-12-01
The blind carbon copy (Bcc) recipients for this message.
Applies To
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).