2.2.5.1 One-Off EntryID Structure

  • Article

A One-Off EntryID structure specifies a set of data representing recipients (1) that do not exist in the directory. All information about a one-off recipient (1) is contained in the EntryID.


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

...

...

...

Version

Pad

MAE

Format

M

U

R

L

Pad

DisplayName (variable)

...

AddressType (variable)

...

EmailAddress (variable)

...

Flags (4 bytes): This value is set to 0x00000000. Bits in this field indicate under what circumstances a short-term EntryID is valid. However, in any EntryID stored in a property value, these 4 bytes are zero, indicating a long-term EntryID.

ProviderUID (16 bytes): The identifier of the provider that created the EntryID. This value is used to route EntryIDs to the correct provider and MUST be set to %x81.2B.1F.A4.BE.A3.10.19.9D.6E.00.DD.01.0F.54.02.

Version (2 bytes): This value is set to 0x0000.

Pad (1 bit): (mask 0x8000) Reserved. This value is set to '0'.

MAE (2 bits): (mask 0x0C00) The encoding used for Macintosh-specific data attachments, as specified in [MS-OXCMAIL] section 2.1.3.4.3. The values for this field are specified in the following table.

Name

Word value

Field value

Description

BinHex

0x0000

b'00'

BinHex encoded.

UUENCODE

0x0020

b'01'

UUENCODED. Not valid if the message is in Multipurpose Internet Mail Extensions (MIME) format, in which case the flag will be ignored and BinHex used instead.

AppleSingle

0x0040

b'10'

Apple Single encoded. Allowed only when the message format is MIME.

AppleDouble

0x0060

b'11'

Apple Double encoded. Allowed only when the message format is MIME.

Format (4 bits): (enumeration, mask 0x1E00) The message format desired for this recipient (1), as specified in the following table.

Name

Word value

Field value

Description

TextOnly

0x0006

b'0011'

Send a plain text message body.

HtmlOnly

0x000E

b'0111'

Send an HTML message body.

TextAndHtml

0x0016

b'1011'

Send a multipart/alternative body with both plain text and HTML.

M (1 bit): (mask 0x0100) A flag that indicates how messages are to be sent. If b'0', indicates messages are to be sent to the recipient (1) in Transport Neutral Encapsulation Format (TNEF) format; if b'1', messages are sent to the recipient (1) in pure MIME format.

U (1 bit): (mask 0x0080) A flag that indicates the format of the string fields that follow. If b'1', the string fields following are in Unicode (UTF-16 form) with 2-byte terminating null characters; if b'0', the string fields following are multibyte character set (MBCS) characters terminated by a single 0 byte.

R (2 bits): (mask 0x0060) Reserved. This value is set to b'00'.

L (1 bit): (mask 0x0010) A flag that indicates whether the server can look up an address in the address book. If b'1', server cannot look up this user's email address in the address book. If b'0', server can look up this user's email address in the address book.

Pad (4 bits): (mask 0x000F) Reserved. This value is set to b'0000'.

DisplayName (variable): The recipient's display name (in the recipient table, the PidTagDisplayName property ([MS-OXCFOLD] section 2.2.2.2.2.5)) as a null-terminated string. If the U field is b'1', the terminating null character is 2 bytes long; otherwise, 1 byte.

AddressType (variable): The recipient's email address type (in the recipient table, the PidTagAddressType property ([MS-OXOABK] section 2.2.3.13)) as a null-terminated string. If the U field is b'1', the terminating null character is 2 bytes long; otherwise, 1 byte.

EmailAddress (variable): The recipient's email address (in the recipient table, the PidTagEmailAddress property ([MS-OXOABK] section 2.2.3.14)) as a null-terminated string. If the U field is b'1', the terminating null character is 2 bytes long; otherwise, 1 byte.