HrGetGALFromEmsmdbUID

Applies to: Outlook 2013 | Outlook 2016

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.

Property Value
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.