Last modified: January 16, 2009
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Returns an ordered list of entry identifiers of the containers to be included in the name resolution process initiated by the IAddrBook::ResolveName method.
Clients and service providers call the GetSearchPath method to get the search path that is used to resolve names with the ResolveName method. Typically, clients call the IAddrBook::SetSearchPath method to establish a container search path in the profile before they call GetSearchPath to retrieve it. However, calling SetSearchPath is optional.
If SetSearchPath has never been called, GetSearchPath builds a path by working through the address book's hierarchy tables. The default search path established by GetSearchPath consists of the following containers in the following order:
The first container with read/write permission, usually the personal address book (PAB).
Every container that has its PR_DISPLAY_TYPE (PidTagDisplayType) property set to DT_GLOBAL. This setting indicates that the container holds recipients.
The container designated as the default, if there are no containers that have the DT_GLOBAL flag set in their PR_DISPLAY_TYPE property and the default container differs from the first container with read/write permission.
If SetSearchPath has been called, GetSearchPath builds a path by using the address book containers that have been stored in the profile. GetSearchPath validates this path before it returns it to the caller.
After the first call to SetSearchPath, subsequent calls to SetSearchPath must be used to modify the search path returned by GetSearchPath. In other words, the calling client or provider does not receive the default search path after the first call to SetSearchPath.