IXMLHTTPRequest2 インターフェイス (msxml6.h)
HTTP 要求を構成および送信し、コールバックを使用して HTTP 応答処理中に通知を受信するために必要なメソッドとプロパティを提供します。
継承
IXMLHTTPRequest2 インターフェイスは、IUnknown インターフェイスから継承されます。 IXMLHTTPRequest2 には、次の種類のメンバーもあります。
メソッド
IXMLHTTPRequest2 インターフェイスには、これらのメソッドがあります。
|
IXMLHTTPRequest2::Abort 現在の HTTP 要求を取り消します。 |
|
IXMLHTTPRequest2::GetAllResponseHeaders すべての HTTP 応答ヘッダーの値を取得します。 |
|
IXMLHTTPRequest2::GetCookie 指定した URL に関連付けられている Cookie を HTTP Cookie jar から取得します。 |
|
IXMLHTTPRequest2::GetResponseHeader 応答ヘッダーから HTTP ヘッダーの値を取得します。 |
|
IXMLHTTPRequest2::Open IXMLHTTPRequest2 要求を初期化し、要求のメソッド、URL、および認証情報を指定します。 このメソッドを呼び出した後、Send メソッドを呼び出して、要求とデータ (存在する場合) をサーバーに送信する必要があります。 |
|
IXMLHTTPRequest2::Send HTTP 要求をサーバーに非同期的に送信します。 成功すると、アプリによって実装された IXMLHTTPRequest2Callback インターフェイスのメソッドが呼び出され、応答が処理されます。 |
|
IXMLHTTPRequest2::SetCookie HTTP Cookie jar 内の指定した URL に関連付けられている Cookie を設定します。 |
|
IXMLHTTPRequest2::SetCustomResponseStream HTTP 応答を受信するための標準ストリームを置き換えるカスタム ストリームを提供します。 |
|
IXMLHTTPRequest2::SetProperty 送信 HTTP 要求のプロパティを設定します。 |
|
IXMLHTTPRequest2::SetRequestHeader 既定の要求ヘッダーと共にサーバーに送信される HTTP ヘッダーの名前を指定します。 |
注釈
IXMLHTTPRequest2 インターフェイスは、IXMLHTTPRequest3 インターフェイスによって拡張されます。 IXMLHTTPRequest3 は、IXMLHTTPRequest2 インターフェイスのすべてのメソッドとプロパティを継承します。
IXMLHTTPRequest2 インターフェイスは、HTTP 要求操作を構成して送信し、コールバックを使用して応答処理中に通知を受信します。 IXMLHTTPRequest2 を使用すると、アプリケーションをマルチスレッド アパートメント (MTA) で実行できます。これは、Windows ランタイム (WinRT) で実行するための要件です。
IXMLHTTPRequest2 インターフェイスでは、次の機能がサポートされています。
- 送信 HTTP 要求のプロパティを設定します。
- 送信 HTTP 要求で使用するために、HTTP Cookie jar に Cookie を設定します。
- HTTP Cookie jar から Cookie を取得します。
- HTTP 応答のダウンロードが完了する前に、受信 HTTP 応答データを処理します。
- HTTP 応答を受信するカスタム ストリームを作成します。
IXMLHTTPRequest2 は、イベント処理用のコールバック モデルを実装します。 IXMLHTTPRequest2 メソッドは非同期メソッド呼び出しのみを許可するため、完了コールバックを受信するには、アプリケーションが IXMLHTTPRequest2::Open メソッドを呼び出して HTTP 要求を作成するときに、IXMLHTTPRequest2Callback オブジェクトへのポインターを渡す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ],MSXML 6.0 以降 |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msxml6.h |