PidTagRecipientType Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains the recipient type for a message recipient.

Remarks

The recipient type contained in this property consists of one required value and one optional flag.

This property must contain exactly one of the following values:

• MAPI_TO
  The recipient is a primary (To) recipient. Clients are required to handle primary recipients. All other types are optional.

• MAPI_CC
  The recipient is a carbon copy (CC) recipient, a recipient that receives a message in addition to the primary recipients.

• MAPI_BCC
  The recipient is a blind carbon copy (BCC) recipient. Primary and carbon copy recipients are unaware of the existence of BCC recipients.

• MAPI_P1
  The recipient did not successfully receive the message on the previous attempt. This is a resend of an earlier transmission.

In addition, the following flag can be set:

• MAPI_SUBMITTED
  The recipient has already received the message and does not need to receive it again. This is a resend of an earlier transmission. This flag is set in conjunction with the MAPI_TO, MAPI_CC, and MAPI_BCC values.

The MAPI_P1 value and the MAPI_SUBMITTED flag are used when a message is being retransmitted due to nondelivery to one or more of the intended recipients. For this retransmission, the client sets MAPI_SUBMITTED on every recipient that does not need the message again but should be displayed in the recipient list. For every recipient that did not receive the message previously, the client retains the original recipient with its PR_RECIPIENT_TYPE value unchanged, but additionally submits a copy of the recipient with MAPI_P1 in place of the original value. This copy, which is discarded before actual delivery, forces the recipient into the P1 envelope and guarantees physical retransmission to that recipient. The PR_RESPONSIBILITY (PidTagResponsibility) property is set to FALSE for MAPI_P1 recipients.

When a client displays a resend form, only the MAPI_P1 recipients are visible. Unless the user enters additional recipients, when the message is delivered, the recipient list appears exactly as it did when the message was sent for the first time.

The PR_DISPLAY_TO (PidTagDisplayTo), PR_DISPLAY_CC (PidTagDisplayCc) and PR_DISPLAY_BCC (PidTagDisplayBcc) properties are related to recipient type. When a client calls a message's IMAPIProp::SaveChanges and there is at least one recipient in the recipient list, the message store provider sets these properties as follows:

In X.400, the P1 or delivery envelope is the information needed to deliver a message, including the recipient's address properties and any option flags controlling delivery and replies. The P2 or display envelope is the information usually displayed to each recipient other than the message text itself. It typically includes the subject, importance, priority, sensitivity, and submission time, as well as the primary and copied recipient names.

Related Resources

Protocol Specifications

• [MS-OXPROPS]
  Provides references to related Exchange Server protocol specifications.

• [MS-OXCMSG]
  Handles message and attachment objects.

• [MS-OXOMSG]
  Specifies the properties and operations that are permissible for e-mail message objects.

• [MS-OXOCAL]
  Specifies the properties and operations for appointment, meeting request, and response messages.

Header Files

• Mapidefs.h
  Provides data type definitions.

• Mapitags.h
  Contains definitions of properties listed as alternate names.

See Also

Reference

PidTagRecipientStatus Canonical Property

PidTagDisplayTo Canonical Property

PidTagDisplayBcc Canonical Property

PidTagDisplayCc Canonical Property

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names