HrOpenABEntryWithExchangeContext

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

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

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

HRESULT HrDoABDetailsWithExchangeContext(
  LPMAPISESSION pmsess,
  const MAPIUID *pEmsmdbUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags
);

Параметры

pmsess

[в] Вошедший в систему IMAPISession. Он не может иметь значение NULL.

pEmsmdbUID

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

pAddrBook

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

cbEntryID

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

lpEntryID

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

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.