IMAPISupport::OpenAddressBook
Область применения: Outlook 2013 | Outlook 2016
Предоставляет доступ к адресной книге.
HRESULT OpenAddressBook(
LPCIID lpInterface,
ULONG ulFlags,
LPADRBOOK FAR * lppAdrBook
);
Параметры
lpInterface
[в] Указатель на идентификатор интерфейса (IID), представляющий интерфейс, используемый для доступа к адресной книге. Допустимые значения: NULL, что указывает стандартный интерфейс адресной книги IAddrBook и IID_IAddrBook.
ulFlags
Защищены; значение должно быть равно нулю.
lppAdrBook
[out] Указатель на указатель на адресную книгу.
Возвращаемое значение
S_OK
Доступ к адресной книге предоставлен.
MAPI_W_ERRORS_RETURNED
Вызов выполнен успешно, но не удалось загрузить один или несколько поставщиков адресной книги. При возврате этого предупреждения вызов должен быть обработан как успешный. Чтобы проверить наличие этого предупреждения, используйте макрос HR_FAILED . Дополнительные сведения см. в разделе Использование макросов для обработки ошибок.
Замечания
Метод IMAPISupport::OpenAddressBook реализован для всех объектов поддержки поставщика услуг. Поставщики услуг, как правило, тесно связанные с хранилищем сообщений и поставщиками транспорта, вызывают OpenAddressBook , чтобы получить доступ к адресной книге. Возвращенный указатель IAddrBook можно использовать для различных задач адресной книги, включая открытие контейнеров адресной книги, поиск пользователей с сообщениями и отображение диалоговых окон с адресами.
Примечания для вызывающих методов
OpenAddressBook может возвращать MAPI_W_ERRORS_RETURNED, если ему не удается загрузить один или несколько поставщиков адресной книги в текущем профиле. Это значение является предупреждением, и вызов следует рассматривать как успешный. Даже если не удалось загрузить все поставщики адресной книги, OpenAddressBook по-прежнему завершается успешно, возвращая MAPI_W_ERRORS_RETURNED и указатель IAddrBook в параметре lppAdrBook . Так как OpenAddressBook всегда возвращает допустимый указатель IAddrBook , его необходимо освободить по завершении использования.
Если не удалось загрузить один или несколько поставщиков адресной книги, вызовите IMAPISupport::GetLastError , чтобы получить структуру MAPIERROR , содержащую сведения о поставщиках, которые не загружались.