IXMLHTTPRequest3 インターフェイス (msxml6.h)

  • [アーティクル]

HTTP 要求を構成して送信し、コールバックを使用して HTTP 応答処理中に通知を受信するために必要なメソッドとプロパティを提供します。 IXMLHTTPRequest2 インターフェイスから派生します。

メモこのインターフェイスは、Windows Phone 8.1 でサポートされています。

 

継承

IXMLHTTPRequest3 インターフェイスは IXMLHTTPRequest2 から継承されます。 IXMLHTTPRequest3 には、次の種類のメンバーもあります。

メソッド

IXMLHTTPRequest3 インターフェイスには、これらのメソッドがあります。

 
IXMLHTTPRequest3::SetClientCertificate

Open メソッドで指定された URL に対する認証に使用するクライアント証明書を設定します。

注釈

IXMLHTTPRequest3 インターフェイスは HTTP 要求を構成して送信し、HTTP 応答処理中にコールバックを使用して通知を受信します。 IXMLHTTPRequest3 インターフェイスを使用すると、アプリをマルチスレッド アパートメント (MTA) で実行できます。これは、Windows ランタイム (WinRT) で実行するための要件です。

IXMLHTTPRequest3 インターフェイスは、IXMLHTTPRequest2 インターフェイスを拡張します。

IXMLHTTPRequest3 インターフェイスと IXMLHTTPRequest3Callback インターフェイスは、IXMLHTTPRequest2 および IXMLHTTPRequest2Callback インターフェイスによって提供される機能を次の追加機能と共に拡張します。

  • IXMLHTTPRequest3 インターフェイスの SetClientCertificate メソッドを使用して、HTTPS 要求に使用するクライアント証明書を設定できます。
  • IXMLHTTPRequest3Callback インターフェイスの OnClientCertificateRequested メソッドを使用して、次の HTTP 要求に使用する対象のクライアント証明書をフィルター処理するのに役立つ発行者リストを取得できるようにします。
  • HTTPS 接続を中止した特定の証明書エラーを無視できるようにします。
  • IXMLHTTPRequest3Callback インターフェイスの OnServerCertificateReceived メソッドを使用して、HTTPS 応答から証明書エラーとサーバー証明書チェーンを取得できるようにします。

IXMLHTTPRequest2 インターフェイスの SetProperty メソッドは、新しいシナリオをサポートするために新しいプロパティを使用して IXMLHTTPRequest3 インターフェイスで拡張されます。

  • XHR_PROP_NO_CACHE – HTTP 要求のキャッシュの読み取りと書き込みを抑制します。
  • XHR_PROP_EXTENDED_ERROR – エラーが発生した場合に、基になる Win32 エラー コードを HRESULTS から OnError メソッドに HTTP スタックに提供します。
  • XHR_PROP_QUERY_STRING_UTF8 – クエリ文字列を HTTP 要求用の ACP ではなく UTF-8 でエンコードします。
  • XHR_PROP_IGNORE_CERT_ERRORS – 特定のサーバー証明書エラーを抑制します。

要件

要件 値
サポートされている最小のクライアント Windows 8.1 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー msxml6.h

こちらもご覧ください

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty