IWinHttpRequest 介面

IWinHttpRequest介面提供Microsoft Windows HTTP 服務的所有 nonevent 方法， (WinHTTP) 。

成員

IWinHttpRequest介面繼承自IUnknown介面。 IWinHttpRequest 也有下列類型的成員：

• 方法
• 屬性

方法

IWinHttpRequest介面具有這些方法。

方法	描述
中止	中止 WinHTTPSend 方法。
GetAllResponseHeaders	擷取所有 HTTP 回應標頭。
GetResponseHeader	擷取 HTTP 回應標頭。
開啟	開啟 HTTP 資源的 HTTP 連線。
發送	將 HTTP 要求傳送至 HTTP 伺服器。
SetAutoLogonPolicy	設定目前的 自動登入原則。
SetClientCertificate	選取要傳送至安全超文字傳輸通訊協定的用戶端憑證， (HTTPS) 伺服器。
SetCredentials	設定要與 HTTP 伺服器、Proxy 伺服器或原始伺服器搭配使用的認證。
SetProxy	設定 Proxy 伺服器資訊。
SetRequestHeader	新增、變更或刪除 HTTP 要求標頭。
SetTimeouts	指定傳送/接收作業的個別逾時元件，以毫秒為單位。
WaitForResponse	等候非同步 Send 方法完成，並採用選擇性逾時值，以秒為單位。

屬性

IWinHttpRequest介面具有這些屬性。

屬性	存取類型	描述
選項	讀取/寫入	WinHTTP 選項值。
ResponseBody	唯讀	回應實體主體做為不帶正負號位元組的陣列。
ResponseStream	唯讀	回應實體主體做為 IStream。
ResponseText	唯讀	回應實體主體。
狀態	唯讀	上一個回應中的 HTTP 狀態碼。
StatusText	唯讀	HTTP 狀態文字。

備註

HTTPrequest.idl 中定義的 IWinHttpRequest 介面是由識別碼為 CLSID_WinHttpRequest的類別所實作。 應用程式藉由呼叫 CoCreateInstance ，其類別識別碼為 CLSID_WinHttpRequest ，以及 IID_IWinHttpRequest的介面識別碼來取得此介面。

注意

針對 Windows XP 和 Windows 2000，請參閱 WinHttp 起始頁面的 執行時間需求 一節。

規格需求

需求	值
最低支援的用戶端	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

另請參閱

IWinHttpRequestEvents

WinHTTP 版本