2.2.9.3 PermanentEntryID

The PermanentEntryID structure identifies a specific object in the address book. Additionally, it encodes the constant Exchange Server NSPI Protocol interface (via the ProviderUID field) and enough information for a client to make a decision as to how to display the object to an end user.

Permanent Entry IDs are transmitted in the protocol as values with the PtypBinary property type.

A server MAY allow an object's distinguished name (DN) to change. If this happens, the server is expected to map a Permanent Entry ID that contains the original DN to the object with the new DN. When returning a PermanentEntryID structure to satisfy a query from a client, a server MUST use the most current version of an object's DN.


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

ID Type

R1

R2

R3

ProviderUID

...

...

...

R4

Display Type String

Distinguished Name (variable)

...

ID Type (1 byte):  The type of this ID. The value is the constant 0x00. The server uses the presence of this value to identify this EntryID as a Permanent Entry ID rather than an Ephemeral Entry ID.

R1 (1 byte):  Reserved. All clients and servers MUST set this value to the constant 0x00.

R2 (1 byte):  Reserved. All clients and servers MUST set this value to the constant 0x00.

R3 (1 byte):  Reserved. All clients and servers MUST set this value to the constant 0x00.

ProviderUID (16 bytes):  A FlatUID_r value that contains the constant GUID specified in Permanent Entry ID GUID, as specified in section 2.2.1.7.

R4 (4 bytes):  Reserved. All clients and servers MUST set this value to the constant 0x00000001.

Display Type String (4 bytes):  The display type of the object specified by this Permanent Entry ID. This value is expressed in little-endian format. Valid values for this field are specified in section 2.2.1.3. The display type is not considered part of the object's identity; it is set in the PermanentEntryID field by the server as a convenience to clients. A server MUST set this field when this data structure is returned in an output parameter. A server MUST ignore values of this field on input parameters.

Distinguished Name (variable):  The DN of the object specified by this Permanent Entry ID. The value is expressed as a DN, as specified in [MS-OXOABK] section 2.2.1.1.<2>

Show: