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.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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>