IXMLHTTPRequest3

HTTP リクエストの構成と送信に必要なメソッドとプロパティを提供し、HTTP レスポンス処理中の通知をコールバックで受け取れるようにします。

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 エラー コードを含む HRESULT を HTTP スタックが OnError メソッドへ渡すようにします。
• XHR_PROP_QUERY_STRING_UTF8 – HTTP リクエストのクエリ文字列を ACP ではなく UTF-8 でエンコードするようにします。
• XHR_PROP_IGNORE_CERT_ERRORS – 特定のサーバー証明書エラーを抑止します。

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

成功した場合は S_OK を返します。