IAddrBook::GetPAB Method

Returns the entry identifier of the default Windows Address Book (WAB) container.

Syntax

HRESULT GetPAB(
    ULONG *lpcbEntryID,
    ENTRYID **lppEntryID
);

Parameters

  • lpcbEntryID
    ULONG Pointer to a variable of type ULONG that receives the returned size of the entry identifier.
  • lppEntryID
    ENTRYID Address of a pointer to a variable of type ENTRYID that receives the returned entry identifier of the default WAB container.

Return Value

HRESULT

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

For versions of the WAB in Microsoft Internet Explorer 4.0 and earlier, the default WAB container represented the entire address book; all address book contents could be accessed through this container.

For WAB clients that specify a profile-aware WAB session using Microsoft Internet Explorer 5 and later, the default WAB container corresponds to the current identity's default Contacts folder. As long as an application calls IAddrBook::GetPAB and manipulates data in the PAB container, all the data will automatically be manipulated within the current Identities folder.

For WAB clients that do not request profile-aware sessions, the container returned by IAddrBook::GetPAB corresponds to the Contacts folder (if there is no Identity Manager) or the Shared Contacts folder (if Identities exist). This folder is available to all WAB users. Application developers who are not interested in profiles can be assured that all their data manipulation in the PAB container is available to all users.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 4.0

Header

Wabiab.h

DLL

Wab32.dll

See Also

IAddrBook

WAB and Multi-User/Multi-Identity Profiles

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010