HrOpenABEntryWithResolvedRow

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

Выполняет ту же функцию, что и HrOpenABEntryWithExchangeContext , за исключением того, что он автоматически получает emsabpUID из разрешенной строки и открывает entryID.

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

HRESULT HrOpenABEntryWithResolvedRow(
  LPSRow prwResolved,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Параметры

prwResolved

[в] Указатель на разрешенную строку, которая используется для получения emsabpUID и открытия entryID.

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] Указатель на указатель открытой записи.