WinHttpRequest オブジェクト

このトピックでは、スクリプト言語で WinHTTP WinHttpRequest COM オブジェクトを使用する方法について説明します。 C++ API (WinHTTP) を含む詳細については、「 WinHTTP について」を参照してください。 これらのインターフェイスの比較については、「 WinHTTP インターフェイスの選択 」を参照してください。

// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
 IWinHttpRequest *  pIWinHttpRequest = NULL;
 \\..
    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }

IWinHttpRequest::Status プロパティから取得したコード例。

メンバー

WinHttpRequest オブジェクトには、次の種類のメンバーがあります。

events

WinHttpRequest オブジェクトには、これらのイベントがあります。

Event 説明
OnError アプリケーションで実行時エラーが発生したときに発生します。
OnResponseDataAvailable 応答からデータを使用できる場合に発生します。
OnResponseFinished 応答データが完了したときに発生します。
OnResponseStart 応答データの受信が開始されたときに発生します。

メソッド

WinHttpRequest オブジェクトには、これらのメソッドがあります。

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

プロパティ

WinHttpRequest オブジェクトには、これらのプロパティがあります。

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

解説

WinHttpRequest オブジェクトは、IErrorInfo インターフェイスを使用してエラー データを提供します。 Microsoft Visual Basic Scripting Edition (VBScript) の Err オブジェクトと、Microsoft JScript の Error オブジェクトを使用して、説明と数値のエラー値を取得できます。 エラー番号の下位 16 ビットは、 エラー メッセージで見つかった値に対応します。

注意

Windows XP と Windows 2000 については、「ランタイム要件」を参照してください。

必要条件

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

関連項目

WinHTTP バージョン