IAddrBook::GetPAB

The IAddrBook::GetPAB method returns the entry identifier of the container designated as the personal address book (PAB).

Quick Info

See IAddrBook : IMAPIProp.

HRESULT GetPAB(
  ULONG FAR * lpcbEntryID,   
  LPENTRYID FAR * lppEntryID  
);
 

Parameters

lpcbEntryID
[out] Pointer to the count of bytes in the entry identifier pointed to by the lppEntryID parameter.
lppEntryID
[out] Pointer to a pointer to the entry identifier of the PAB. The lppEntryID parameter contains zero if no container has been designated as the PAB.

Return Values

S_OK
The entry identifier of the PAB was successfully returned.

Remarks

Clients call the IAddrBook::GetPAB method to retrieve the entry identifier of the container designated as the PAB. If a PAB has not been established in the profile, MAPI selects as the PAB the first container in the address book hierarchy that allows modifications.

See Also

MAPIAllocateBuffer, MAPIFreeBuffer, PR_CONTAINER_FLAGS