2.2.5 Properties That Reference Other Address Book Objects

Some Address Book objects contain references to other Address Book objects, in the form of a table, through various properties.

For details about accessing these tables from an address book server, see [MS-NSPI] and [MS-OXNSPI] section 3.1.4.4.2.2.<38> Each of these properties is of type PtypEmbeddedTable ([MS-OXCDATA] section 2.11.1). For example, a mail user in an organization reports to a manager, who is also listed in that address book as another mail user. In this case, a property of type PtypEmbeddedTable or PidTagAddressBookManager (section 2.2.5.1) references the manager. In general, a property of type PtypEmbeddedTable references any number of other Address Book objects. Properties of type PtypEmbeddedTable are made available on an address book server by using a property value–based explicit table through either the NspiGetMatches method, as specified in [MS-NSPI] and [MS-OXNSPI] section 3.1.4.1.10, or the GetMatches request type, as specified in [MS-OXCMAPIHTTP] section 2.2.5.5, and are modified through either the NspiModLinkAtt method, as specified in [MS-NSPI] and [MS-OXNSPI] section 3.1.4.1.15, or the ModLinkAtt request type, as specified in [MS-OXCMAPIHTTP] section 2.2.5.10.<39><40>

These tables are represented in an offline address book (OAB) as a property either of type PtypString ([MS-OXCDATA] section 2.11.1) (for tables that consist of no more than one reference) or of type PtypMultipleString ([MS-OXCDATA] section 2.11.1) (for tables that can consist of multiple references), as specified in [MS-OXOAB]. Each string value represents the DN of another Address Book object. For example, a mail user in an organization reports to a manager who is also listed in the address book as another mail user. In this case, the PidTagAddressBookManager property (section 2.2.5.1), with a property type of PtypString, contains the DN of the manager.