IXMLHTTPRequest2Callback::OnRedirect メソッド (msxml6.h)
クライアントが、サーバーが新しい URL にリダイレクトする HTTP 要求を送信するときに発生します。
構文
HRESULT OnRedirect(
[in, optional] IXMLHTTPRequest2 *pXHR,
[in] const WCHAR *pwszRedirectUrl
);
パラメーター
[in, optional] pXHR
リダイレクトされる HTTP 要求オブジェクト。
[in] pwszRedirectUrl
HTTP 要求の新しい URL。
戻り値
成功すると S_OK を返します。
メモ このコールバック関数は例外をスローしてはなりません。
注釈
要求のリダイレクトが許可されていない場合は、pXHR オブジェクトで Abort メソッドを呼び出すことができます。
XMLHTTPRequest2 では、任意の要求に対して最大 100 の再方向が適用されます。 この制限を超える再方向では 、OnError イベントが生成されます。 アプリケーションは、再方向のヘッダーにアクセスできなくなります。
最終的なリダイレクトが完了し、最終的な URL に達すると、アプリケーションは OnHeadersAvailable コールバックを受け取ります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ],MSXML 6.0 以降 |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msxml6.h |