通过

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

[in]以 null 结尾的简单邮件传输协议 (SMTP) 要为其检索自动发现信息的帐户的电子邮件地址。

pwzPassword

[in] pwzAddress 指定的帐户的可选密码。 请注意，如果 pwzAddress 指定的帐户不需要密码，则传递任何密码都不起作用。

hCancelEvent

[in]一个取消设置 Win32 事件句柄，该句柄是可选的，可用于取消操作。 若要取消操作，请设置事件并将事件句柄作为 hCancelEvent 传递;如果不想取消操作，请传递 null 。 请注意，传递一个不表示事件句柄的值不起作用，并且会被函数忽略。

ulFlags

[in]不使用此参数。 它必须为 0。

ppXmlStream

[out]指向包含自动发现 XML 的 IStream 对象的指针。 如果自动发现操作失败，则返回 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 字节的内部缓冲区。