共用方式為


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物件具有這些事件。

事件 描述
OnError 發生于應用程式中發生執行階段錯誤時。
OnResponseDataAvailable 發生于從回應取得資料時。
OnResponseFinished 發生于回應資料完成時。
OnResponseStart 發生于回應資料開始接收時。

方法

WinHttpRequest物件具有這些方法。

方法 描述
中止 中止 WinHTTPSend 方法。
GetAllResponseHeaders 擷取所有 HTTP 回應標頭。
GetResponseHeader 擷取 HTTP 回應標頭。
開啟 開啟 HTTP 資源的 HTTP 連線。
發送 將 HTTP 要求傳送至 HTTP 伺服器。
SetAutoLogonPolicy 設定目前的 自動登入原則
SetClientCertificate 選取要傳送至安全超文字傳輸通訊協定的用戶端憑證, (HTTPS) 伺服器。
SetCredentials 設定要與來源或 Proxy 伺服器搭配使用的認證。
SetProxy 設定 Proxy 伺服器資訊。
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、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
可轉散發套件
Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更新版本。
Idl
HttpRequest.idl
程式庫
WinHTTP.lib
DLL
Winhttp.dll

另請參閱

WinHTTP 版本