Export (0) Print
Expand All
Expand Minimize

PidTagAddressBookHierarchicalRootDepartment

Published: July 16, 2012

Contains the distinguished name (DN) of the hierarchical address root (HAB).

Associated properties:

PR_EMS_AB_HAB_ROOT_DEPARTMENT, PR_EMS_AB_HAB_ROOT_DEPARTMENT_A

Property set:

Address Book

Long ID (LID):

0x8C98

Data type:

PT_STRING8

Area:

Exchange Address Book

This is a property on the global address list (GAL) container and represents the distinguished name of the hierarchical address root. This property is only present in the offline address book and never in Active Directory Domain Services (AD DS). Callers should pass MAPI_CACHE_ONLY to the GetProps call to avoid a remote procedure call. If this is not present, callers should use PR_EMS_AB_HAB_ROOT_DEPARTMENT, which is of type PT_OBJECT, to find the root department.

Once the root department is obtained, it can have an object type MAPI_MAILUSER or MAPI_DISTLIST. If the object type is MAPI_DISTLIST, the new schema is being employed. If the object type is MAPI_MAILUSER, the previous schema is being employed.

  • Microsoft Office Outlook 2007 Service Pack 2 supports both schemas.

  • Microsoft Outlook 2010 and Microsoft Outlook 2013 support the new schema.

In the new schema, all departmental groups are also distribution lists and are of type MAPI_DISTLIST. Members of departmental groups, and departments within departmental groups are obtained by using PR_EMS_AB_MEMBER, exactly like distribution list members.

Once the root department is obtained, it can have an object type MAPI_MAILUSER or MAPI_DISTLIST. If the object type is MAPI_DISTLIST, the new schema is being used. If the object type is MAPI_MAILUSER, the old schema is being used.

In the new schema, all departmental groups are also DLs and are of type MAPI_DISTLIST.

Protocol Specifications

[MS-OXPROPS]

Provides property set definitions and references to related Exchange Server protocol specifications.

Header Files

Mapidefs.h

Provides data type definitions.

Community Additions

ADD
Show:
© 2014 Microsoft