IWinHttpRequest 接口

IWinHttpRequest 接口提供 Microsoft Windows HTTP Services (WinHTTP) 的所有 nonevent 方法。

成员

IWinHttpRequest 接口继承自 IUnknown 接口。 IWinHttpRequest 还具有以下类型的成员：

• 方法
• 属性

方法

IWinHttpRequest 接口具有这些方法。

方法	说明
中止	中止 WinHTTPSend 方法。
GetAllResponseHeaders	检索所有 HTTP 响应标头。
GetResponseHeader	检索 HTTP 响应标头。
打开	打开与 HTTP 资源的 HTTP 连接。
发送	将 HTTP 请求发送到 HTTP 服务器。
SetAutoLogonPolicy	设置当前的 自动登录策略。
SetClientCertificate	选择要发送到安全超文本传输协议 (HTTPS) 服务器的客户端证书。
SetCredentials	设置要与 HTTP 服务器（代理服务器或原始服务器）一起使用的凭据。
SetProxy	设置代理服务器信息。
SetRequestHeader	添加、更改或删除 HTTP 请求标头。
SetTimeouts	指定发送/接收操作的各个超时组件（以毫秒为单位）。
WaitForResponse	等待异步 Send 方法完成，并具有可选的超时值（以秒为单位）。

属性

IWinHttpRequest 接口具有以下属性。

属性	访问类型	说明
选项	读取/写入	WinHTTP 选项值。
ResponseBody	只读	响应实体正文作为无符号字节数组。
ResponseStream	只读	作为 IStream 的响应实体正文。
ResponseText	只读	响应实体正文。
状态	只读	上一个响应中的 HTTP 状态代码。
StatusText	只读	HTTP 状态文本。

备注

httprequest.idl 中定义的 IWinHttpRequest 接口由 id 为 CLSID_WinHttpRequest 的类实现。 应用程序通过调用 CoCreateInstance 获取此接口，类 ID 为 CLSID_WinHttpRequest ，接口 ID 为 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 版本