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 バイトの内部バッファーがオーバーフローします。