HrGetAutoDiscoverXML

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

Microsoft Exchange 2007 サーバーの自動検出サービスから取得した情報を表す拡張マークアップ言語 (XML) ストリームを返します。

クイック ヒント

プロパティ 値
エクスポート者:
 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 オブジェクトへの null ポインターです。

MAPI_E_NOT_FOUND

  • クライアント コンピューターがネットワークに接続されていない、クライアント コンピューターが Microsoft Exchange 2007 サーバーに接続されていない、 pwzAddress が Exchange 2007 サーバー上のアカウントではない、 または pwzAddress が Exchange 自動検出サービスをサポートしていないアカウントです。

MAPI_E_USER_CANCEL

  • 操作を取り消すために、イベント ハンドルが hCancelEvent に渡されました。

STRSAFE_E_INSUFFICIENT_BUFFER

  • pwzAddress または pwzPassword に渡される値が長すぎるため、サイズ 256 バイトの内部バッファーがオーバーフローします。