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 |
|
| ライブラリ |
|
| [DLL] |
|