Поделиться через

HrGetAutoDiscoverXML

  • Статья

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

Возвращает поток XML, представляющий сведения, полученные из службы автоматического обнаружения сервера Microsoft Exchange 2007.

Краткие сведения

Свойство Значение
Экспортировано:
 olmapi32.dll
Вызывающая сторона:
 Клиент
Реализовано в:
 Outlook
 
HRESULT HrGetAutoDiscoverXML( 
    __in_z const WCHAR *pwzAddress, 
    __in_opt_z const WCHAR *pwzPassword, 
    __in_opt HANDLE hCancelEvent, 
    __in_opt ULONG ulFlags, 
    __out IStream** ppXmlStream);

Параметры

pwzAddress

[в] Url-адрес электронной почты smtp для учетной записи, для которой требуется получить сведения об автоматическом обнаружении, с прекращением действия NULL.

pwzPassword

[в] Необязательный пароль для учетной записи, указанной pwzAddress. Обратите внимание, что передача пароля не действует, если для учетной записи, указанной pwzAddress , не требуется пароль.

hCancelEvent

[в] Необязательный дескриптор событий Win32, который можно использовать для отмены операции. Чтобы отменить операцию, задайте событие и передайте дескриптор события как hCancelEvent; если вы не хотите отменять операцию, передайте значение NULL . Обратите внимание, что передача значения, не представляющего дескриптор события, не оказывает влияния и игнорируется функцией.

ulFlags

[в] Этот параметр не используется. Должно быть 0.

ppXmlStream

[out] Указатель на объект IStream , содержащий XML-код автообнаружения. Возвращает значение NULL в случае сбоя операции автообнаружения. После завершения работы с ним необходимо освободить объект IStream .

Возвращаемые значения

S_OK

  • Вызов функции выполнен успешно.

E_INVALIDARG

  • pwzAddress имеет значение NULL или не является допустимым SMTP-адресом, или ppXmlStream является пустым указателем на объект IStream .

MAPI_E_NOT_FOUND

  • Клиентский компьютер не подключен к сети, клиентский компьютер не подключен к серверу Microsoft Exchange 2007, pwzAddress не является учетной записью на сервере Exchange 2007 или pwzAddress — это учетная запись, которая не поддерживает службу автоматического обнаружения Exchange.

MAPI_E_USER_CANCEL

  • Дескриптор события передан в hCancelEvent для отмены операции.

STRSAFE_E_INSUFFICIENT_BUFFER

  • Значение, передаваемое в pwzAddress или pwzPassword , слишком длинное, поэтому оно переполняет внутренний буфер размером 256 байт.