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 |
|
| 程式庫 |
|
| DLL |
|