WinHttpRequest 对象
本主题提供有关将 WinHTTP WinHttpRequest COM 对象与脚本语言配合使用的信息。 有关详细信息，包括 C++ API (WinHTTP) ，请参阅 About 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 | 设置要与 HTTP 服务器（源或代理服务器）一起使用的凭据。 |
| SetProxy | 设置代理服务器信息。 |
| 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 SP3 Professional 2000 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2003，Windows SP3 的 2000 Server [仅限桌面应用] |
| 可再发行组件 |
Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更高版本。 |
| IDL |
|
| 库 |
|
| DLL |
|