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	设置要用于 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 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

另请参阅

WinHTTP 版本