HrOpenABEntryWithProviderUID

Область применения: Outlook 2013 | Outlook 2016

Открывает идентификатор входа с помощью адресной книги Exchange, определенной pEmsabpUID. Эта функция работает аналогично IAddrBook::OpenEntry , за исключением того, что использование этой функции гарантирует открытие IAddrBook::OpenEntry с помощью ожидаемого поставщика адресной книги Exchange.

Свойство	Значение
Файл заголовка:	abhelp.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики услуг

HRESULT HrOpenABEntryWithProviderUID(
  const MAPIUID *pEmsabpUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Параметры

pEmsmdbUID

[в] Указатель на emsmdbUID , который идентифицирует службу Exchange, содержащую поставщика адресной книги Exchange, который эта функция должна использовать для отображения сведений об идентификаторе записи. Если идентификатор входящей записи не является идентификатором записи поставщика адресной книги Exchange, этот параметр игнорируется, а вызов функции ведет себя как IAddrBook::D etails. Если этот параметр имеет значение NULL или ноль MAPIUID, эта функция ведет себя как IAddrBook::D etails.

pAddrBook

[в] Адресная книга, используемая для открытия идентификатора записи. Он не может иметь значение NULL.

cbEntryID

[в] Число байтов идентификатора записи, заданного параметром lpEntryID .

lpEntryID

[в] Указатель на идентификатор записи, представляющий открываемую запись адресной книги.

lpInterface

[в] Указатель на идентификатор интерфейса (IID), используемый для доступа к открытой записи. Передача NULL возвращает стандартный интерфейс объекта . Для пользователей обмена сообщениями стандартным интерфейсом является IMailUser : IMAPIProp. Для списков рассылки это IDistList : IMAPIContainer, а для контейнеров — IABContainer : IMAPIContainer. Вызывающие лица могут задать для lpInterface соответствующий стандартный интерфейс или интерфейс в иерархии наследования.

ulFlags

[в] Битовая маска флагов, управляющая способом открытия записи. Можно задать следующие флаги:

MAPI_BEST_ACCESS

Запрашивает открытие записи с максимально допустимыми разрешениями сети и клиента. Например, если клиент имеет разрешение на чтение и запись, поставщик адресной книги пытается открыть запись с разрешением на чтение и запись. Клиент может получить предоставленный уровень доступа, вызвав метод IMAPIProp::GetProps открытой записи и получите свойство PR_ACCESS_LEVEL (PidTagAccessLevel).

MAPI_CACHE_ONLY

Используйте только автономную адресную книгу для разрешения имен. Например, этот флаг можно использовать, чтобы разрешить клиентскому приложению открывать глобальный список адресов (GAL) в режиме кэшированного обмена и получать доступ к записи в этой адресной книге из кэша без создания трафика между клиентом и сервером. Этот флаг поддерживается только поставщиком адресной книги Exchange.

MAPI_DEFERRED_ERRORS

Позволяет выполнить вызов, возможно, до того, как запись будет полностью открыта и доступна, что означает, что последующие вызовы записи могут возвращать ошибку.

MAPI_GAL_ONLY

Используйте только глобальный список адресов для разрешения имен. Этот флаг поддерживается только поставщиком адресной книги Exchange.

MAPI_MODIFY

Запрашивает открытие записи с разрешением на чтение и запись. Так как записи по умолчанию открываются с доступом только для чтения, клиенты не должны предполагать, что разрешение на чтение и запись было предоставлено независимо от того, задано ли MAPI_MODIFY.

MAPI_NO_CACHE

Не используйте автономную адресную книгу для разрешения имен. Этот флаг поддерживается только поставщиком адресной книги Exchange.

lpulObjType

[out] Указатель на тип открытой записи.

lppUnk

[out] Указатель на указатель открытой записи.