Platform SDK: CDO for Windows 2000

recipientlist Field

The message's recipient list.

Full Name

http://schemas.microsoft.com/cdo/smtpenvelope/recipientlist

OLE DB Type

DBTYPE_WSTR

Variant SubType

[Visual Basic] String

[C++] BSTR

Remarks

This address list corresponds the set of RCPT TO SMTP commands received for the message, or the x-receiver headers present at the top of the message if submitted using the SMTP pickup directory.

Each address is delimited with "SMTP:" as a prefix and ";" as a suffix. For example:

SMTP:user1@microsoft.com;SMTP:user2@microsoft.com;

One common use of this field is for distribution list expansion. An email message could arrive at the local machine with a recipientlist containing the name of an alias. An event sink could internally remove the alias name and then add the list members in its place.

Example