IWinHttpRequest インターフェイス

  • [アーティクル]

IWinHttpRequest インターフェイスは、Microsoft Windows HTTP Services (WinHTTP) のすべての非イベント メソッドを提供します。

メンバー

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

メソッド

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

メソッド 説明
中止 WinHTTPSend メソッドを中止します。
GetAllResponseHeaders すべての HTTP 応答ヘッダーを取得します。
GetResponseHeader HTTP 応答ヘッダーを取得します。
[ファイル] HTTP リソースへの HTTP 接続を開きます。
Send HTTP 要求を HTTP サーバーに送信します。
SetAutoLogonPolicy 現在の 自動ログオン ポリシーを設定します。
SetClientCertificate セキュリティで保護されたハイパーテキスト転送プロトコル (HTTPS) サーバーに送信するクライアント証明書を選択します。
SetCredentials HTTP サーバー (プロキシ サーバーまたは発信元サーバー) で使用する資格情報を設定します。
SetProxy プロキシ サーバー情報を設定します。
SetRequestHeader HTTP 要求ヘッダーを追加、変更、または削除します。
SetTimeouts 送受信操作の個々のタイムアウト コンポーネントをミリ秒単位で指定します。
WaitForResponse 非同期の Send メソッドが完了するまで待機します(省略可能なタイムアウト値を秒単位)。

プロパティ

IWinHttpRequest インターフェイスには、これらのプロパティがあります。

プロパティ アクセスの種類 説明
オプション
 読み取り/書き込み
 WinHTTP オプション値。
ResponseBody
 読み取り専用
 符号なしバイト配列としての応答エンティティ ボディ。
ResponseStream
 読み取り専用
 応答エンティティ本文を IStream として指定します。
ResponseText
 読み取り専用
 応答エンティティ本文。
Status
 読み取り専用
 最後の応答からの HTTP 状態コード。
StatusText
 読み取り専用
 HTTP 状態テキスト。

解説

httprequest.idl で定義されている IWinHttpRequest インターフェイスは、id が CLSID_WinHttpRequest のクラスによって実装されます。 アプリケーションは、CLSID_WinHttpRequest のクラス ID と IID_IWinHttpRequest のインターフェイス ID を使用して CoCreateInstance を呼び出すことによって、このインターフェイスを取得します。

注意

Windows XP および Windows 2000 の場合は、WinHttp スタート ページの 「ランタイム要件 」セクションを参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows XP、Windows 2000 Professional sp3 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
再頒布可能パッケージ
 Windows XP および Windows 2000 で WinHTTP 5.0 およびインターネット エクスプローラー 5.01 以降。
IDL
HttpRequest.idl
ライブラリ
Winhttp.lib
[DLL]
Winhttp.dll

関連項目

IWinHttpRequestEvents

WinHTTP バージョン