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 版本