2.2.2.2.4.1.1 WrappedEntryId Structure

  • Article

The WrappedEntryId structure specifies the EntryID of a member of a personal distribution list. The following diagram specifies the format of the WrappedEntryId 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

Flags

ProviderUID

...

...

...

Type

EmbeddedEntryID (variable)

...

Flags (4 bytes):  Not used. This field MUST be set to 0x00000000.

ProviderUID (16 bytes):  This field MUST contain the value "%xC0.91.AD.D3.51.9D.CF.11.A4.A9.00.AA.00.47.FA.A4".

Type (1 byte):  An 8-bit value that specifies how the EmbeddedEntryID field is interpreted and MUST be a combination of bits from the following table.

Bit mask

Description

0x0F

The lower 4 bits of the Type field are interpreted as an unsigned integer value that specifies what type of EntryID is embedded in this Wrapped EntryID structure. These bits MUST be set to one of the following values:

  • A value of 0 designates a one-off EntryID; the EmbeddedEntryID field MUST be a One-Off EntryID structure ([MS-OXCDATA] section 2.2.5.1).

  • A value of 3 designates the EntryID of a Contact object; the EmbeddedEntryID field MUST be a Message EntryID structure ([MS-OXCDATA] section 2.2.4.2).

  • A value of 4 designates the EntryID of a Personal Distribution List object; the EmbeddedEntryID field MUST be a Message EntryID structure ([MS-OXCDATA] section 2.2.4.2).

  • A value of 5 designates the EntryID of a mail user in the GAL; the EmbeddedEntryID field MUST be an Address Book EntryID structure ([MS-OXCDATA] section 2.2.5.2).

  • A value of 6 designates the EntryID of a distribution list in the GAL; the EmbeddedEntryID field MUST be an Address Book EntryID structure ([MS-OXCDATA] section 2.2.5.2).

0x70

The next 3 bits of the Type field are interpreted as an unsigned integer value. If the EmbeddedEntryID field contains a one-off EntryID, this value MUST be 0. If the EmbeddedEntryID field does not contain the EntryID of a Contact object, this value MUST be 3.

If the EmbeddedEntryID field contains a the EntryID of a Contact object, this unsigned integer MUST have one of the following values:

  • 0 (denoting a Business Fax electronic address)

  • 1 (denoting a Home Fax electronic address)

  • 2 (denoting a Primary Fax electronic address)

  • 4 (denoting an Email1 address)

  • 5 (denoting an Email2 address)

  • 6 (denoting an Email3 address)

Note that this value MUST NOT be set to 7.

0x80

If the EmbeddedEntryID field contains a one-off EntryID, this bit MUST NOT be set. Otherwise, this bit MUST be set.

EmbeddedEntryID (variable):  An array of bytes that specifies an EntryID that MUST be interpreted according to the value of the Type field, more specifically according to the value contained in the lower 4 bits of the Type field, as specified in the previous table.