2.8.3.2 RecipientRow Structure


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

RecipientFlags

AddressPrefixUsed (optional)

DisplayType (optional)

X500DN (optional) (variable)

...

EntryIdSize (optional)

EntryID (optional) (variable)

...

SearchKeySize (optional)

SearchKey (optional) (variable)

...

AddressType (optional) (variable)

...

EmailAddress (optional) (variable)

...

DisplayName (optional) (variable)

...

SimpleDisplayName (optional) (variable)

...

TransmittableDisplayName (optional) (variable)

...

RecipientColumnCount

RecipientProperties (variable)

...

RecipientFlags (2 bytes): A RecipientFlags structure, as specified in section 2.8.3.1. This value specifies the type of recipient (1) and which standard properties are included.

AddressPrefixUsed (optional) (1 byte): Unsigned integer. This field MUST be present when the Type field of the RecipientFlags field is set to X500DN (0x1) and MUST NOT be present otherwise. This value specifies the amount of the Address Prefix is used for this X500 DN. The Address Prefix is used only in the context of a bulk data transfer buffer, and is specified there by the MetaTagDnPrefix meta-property. For details about the MetaTagDnPrefix meta-property, see [MS-OXCFXICS] section 2.2.4.1.5.6.

DisplayType (optional) (1 byte): An enumeration. This field MUST be present when the Type field of the RecipientFlags field is set to X500DN (0x1) and MUST NOT be present otherwise. This value specifies the display type of this address. Valid values for this field are specified in the following table.

Value

Meaning

0x00

A messaging user

0x01

A distribution list

0x02

A forum, such as a bulletin board service or a public or shared folder

0x03

An automated agent

0x04

An Address Book object defined for a large group, such as helpdesk, accounting, coordinator, or department

0x05

A private, personally administered distribution list

0x06

An Address Book object known to be from a foreign or remote messaging system

X500DN (optional) (variable): A null-terminated ASCII string. This field MUST be present when the Type field of the RecipientFlags field is set to X500DN (0x1) and MUST NOT be present otherwise. This value specifies the X500 DN of this recipient (1).

EntryIdSize (optional) (2 bytes): An unsigned integer. This field MUST be present when the Type field of the RecipientFlags field is set to PersonalDistributionList1 (0x6) or PersonalDistributionList2 (0x7). This field MUST NOT be present otherwise. This value specifies the size of the EntryID field.

EntryID (optional) (variable): An array of bytes. This field MUST be present when the Type field of the RecipientFlags field is set to PersonalDistributionList1 (0x6) or PersonalDistributionList2 (0x7). This field MUST NOT be present otherwise. The number of bytes in this field MUST be the same as specified in the EntryIdSize field. This array specifies the address book EntryID structure, as specified in section 2.2.5.2, of the distribution list.

SearchKeySize (optional) (2 bytes): An unsigned integer. This field MUST be present when the Type field of the RecipientFlags field is set to PersonalDistributionList1 (0x6) or PersonalDistributionList2 (0x7). This field MUST NOT be present otherwise. This value specifies the size of the SearchKey field.

SearchKey (optional) (variable): An array of bytes. This field is used when the Type field of the RecipientFlags field is set to PersonalDistributionList1 (0x6) or PersonalDistributionList2 (0x7). This field MUST NOT be present otherwise. The number of bytes in this field MUST be the same as what is specified in the SearchKeySize field and can be 0. This array specifies the search key of the distribution list.

AddressType (optional) (variable): A null-terminated ASCII string. This field MUST be present when the Type field of the RecipientsFlags field is set to NoType (0x0) and the O flag of the RecipientsFlags field is set. This field MUST NOT be present otherwise. This string specifies the address type of the recipient (1).

EmailAddress (optional) (variable): A null-terminated string. This field MUST be present when the E flag of the RecipientsFlags field is set and MUST NOT be present otherwise. This field MUST be specified in Unicode characters if the U flag of the RecipientsFlags field is set and in the 8-bit character set otherwise. This string specifies the email address of the recipient (1).

DisplayName (optional) (variable): A null-terminated string. This field MUST be present when the D flag of the RecipientsFlags field is set and MUST NOT be present otherwise. This field MUST be specified in Unicode characters if the U flag of the RecipientsFlags field is set and in the 8-bit character set otherwise. This string specifies the email address of the recipient (1).

SimpleDisplayName (optional) (variable): A null-terminated string. This field MUST be present when the I flag of the RecipientsFlags field is set and MUST NOT be present otherwise. This field MUST be specified in Unicode characters if the U flag of the RecipientsFlags field is set and in the 8-bit character set otherwise. This string specifies the email address of the recipient (1).

TransmittableDisplayName (optional) (variable): A null-terminated string. This field MUST be present when the T flag of the RecipientsFlags field is set and MUST NOT be present otherwise. This field MUST be specified in Unicode characters if the U flag of the RecipientsFlags field is set and in the 8-bit character set otherwise. This string specifies the email address of the recipient (1).

RecipientColumnCount (2 bytes): An unsigned integer. This value specifies the number of columns from the RecipientColumns field ([MS-OXCROPS] section 2.2.6.16.2) that are included in the RecipientProperties field.

RecipientProperties (variable): PropertyRow structures, as specified in section 2.8.1. The columns used for this row are those specified in RecipientProperties.