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 |
|
库 |
|
DLL |
|