iXMLHTTPRequest3 接口 (msxml6.h)
提供配置和发送 HTTP 请求以及使用回调在 HTTP 响应处理期间接收通知所需的方法和属性。 派生自 IXMLHTTPRequest2 接口。
注意Windows Phone 8.1 支持此接口。
继承
IXMLHTTPRequest3 接口继承自 IXMLHTTPRequest2。 IXMLHTTPRequest3 还具有以下类型的成员:
方法
IXMLHTTPRequest3 接口包含以下方法。
IXMLHTTPRequest3::SetClientCertificate 设置要用于对 Open 方法中指定的 URL 进行身份验证的客户端证书。 |
注解
IXMLHTTPRequest3 接口配置和发送 HTTP 请求,并使用回调在 HTTP 响应处理期间接收通知。 IXMLHTTPRequest3 接口允许应用在多线程单元中运行, (MTA) ,这是在 Windows 运行时 (WinRT) 下运行的要求。
IXMLHTTPRequest3 接口扩展了 IXMLHTTPRequest2 接口。
IXMLHTTPRequest3 和 IXMLHTTPRequest3Callback 接口通过以下新增功能扩展了 IXMLHTTPRequest2 和 IXMLHTTPRequest2Callback 接口提供的功能:
- 允许使用 IXMLHTTPRequest3 接口上的 SetClientCertificate 方法设置用于 HTTPS 请求的客户端证书。
- 允许使用 IXMLHTTPRequest3Callback 接口上的 OnClientCertificateRequested 方法获取颁发者列表,以帮助筛选符合条件的客户端证书,以用于下一个 HTTP 请求。
- 允许忽略某些证书错误,否则这些错误会中止 HTTPS 连接。
- 允许使用 IXMLHTTPRequest3Callback 接口上的 OnServerCertificateReceived 方法从 HTTPS 响应获取证书错误和服务器证书链。
IXMLHTTPRequest2 接口上的 SetProperty 方法在 IXMLHTTPRequest3 接口上使用新属性进行扩展,以支持新方案:
- XHR_PROP_NO_CACHE – 取消 HTTP 请求的缓存读取和写入。
- XHR_PROP_EXTENDED_ERROR – 导致 HTTP 堆栈在发生故障时向 OnError 方法提供带有基础 Win32 错误代码的 HRESULTS。
- XHR_PROP_QUERY_STRING_UTF8 – 使查询字符串在 UTF-8 中编码,而不是 HTTP 请求的 ACP。
- XHR_PROP_IGNORE_CERT_ERRORS – 取消某些服务器证书错误。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8.1 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2012 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | msxml6.h |