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 オブジェクトには、次の種類のメンバーがあります。

イベント

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

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

メソッド

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

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

プロパティ

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

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

解説

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

Note

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

要件

要件 値
サポートされている最小のクライアント
 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

関連項目

WinHTTP バージョン