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 オブジェクトには、これらのメソッドがあります。

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

Properties

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、Windows 2000 Professional SP3 [ デスクトップアプリのみ]
サポートされている最小のサーバー
Windows Server 2003、Windows 2000 Server SP3 [ デスクトップアプリのみ]
再頒布可能パッケージ
Windows XP および Windows 2000 の WinHTTP 5.0 および Internet Explorer 5.01 以降。
IDL
HttpRequest
ライブラリ
Winhttp .lib
[DLL]
Winhttp.dll

関連項目

WinHTTP のバージョン