HrGetGALFromEmsmdbUID

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Returns the entry identifier of the global address book for the Exchange service identified by pEmsmdbUID. The returned entry identifier should be freed using MAPIFreeBuffer.

Header file:

abhelp.h

Implemented by:

MAPI

Called by:

Client applications and service providers

HRESULT HrGetGALFromEmsmdbUID(
  LPMAPISESSION pSess,
  LPADRBOOK lpAdrBook,
  const MAPIUID * pEmsmdbUID,
  ULONG * lpcbeid,
  LPENTRYID * lppeid
);

Parameters

  • pSess
    [in] The logged on IMAPISession. It cannot be NULL.

  • pAddrBook
    [in] The address book used to open the entry identifier. It cannot be NULL.

  • pEmsmdbUID
    [in] A pointer to an emsmdbUID that identifies the GAL of the Exchange Service to be retrieved. If pEmsmdbUID is NULL or the zero UID, this function gets the legacy GAL of the Exchange Service.

  • lpcbeid
    [out] A pointer to the byte count of the entry identifier of the global address list.

  • lppeid
    [out] A pointer to the entry identifier of the global address list. This should be freed using MAPIFreeBuffer.