iXMLHTTPRequest2：：SetProperty 方法 (msxml6.h)

设置传出 HTTP 请求的属性。

语法

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

[in] eProperty

以下为有效值：

Value	含义
XHR_PROP_NO_CRED_PROMPT	禁止自动提示用户凭据
XHR_PROP_NO_AUTH	禁止 HTTP 堆栈代表应用程序执行的身份验证
XHR_PROP_TIMEOUT	将所有超时值设置为 ullValue 给出的值（以毫秒为单位）。
XHR_PROP_NO_DEFAULT_HEADERS	禁止向 HTTP 请求添加默认标头。
XHR_PROP_REPORT_REDIRECT_STATUS	使 HTTP 堆栈使用临时重定向状态代码调用 OnHeadersAvailable 方法。对于其他重定向和最终目标状态代码，将再次调用 OnHeadersAvailable 方法。
XHR_PROP_NO_CACHE	禁止缓存 HTTP 请求的读取和写入。 IXMLHTTPRequest3 接口支持此属性。
XHR_PROP_EXTENDED_ERROR	导致 HTTP 堆栈在发生故障时向 OnError 方法提供带有基础 Win32 错误代码的 HRESULTS。 IXMLHTTPRequest3 接口支持此属性。
XHR_PROP_QUERY_STRING_UTF8	将查询字符串编码为 UTF-8 而不是 HTTP 请求的 ACP。 IXMLHTTPRequest3 接口支持此属性。
XHR_PROP_IGNORE_CERT_ERRORS	取消某些证书错误。 IXMLHTTPRequest3 接口支持此属性。

[in] ullValue

指定应用程序在超时前等待的毫秒数。

值	含义
XHR_PROP_NO_CRED_PROMPT	此参数可以是 Msxml6.h 头文件中定义的 XHR_CRED_PROMPT 枚举类型的值之一。 XHR_CRED_PROMPT_ALL 是否应 (默认) 启用凭据提示。 XHR_CRED_PROMPT_NONE 是否应禁用凭据提示。如果仅应为代理身份验证启用凭据提示，XHR_CRED_PROMPT_PROXY。
XHR_PROP_NO_AUTH	此参数可以是 msxml6.h 头文件中定义的 XHR_AUTH 枚举类型的值之一。 XHR_AUTH_ALL 是否 (默认) 启用身份验证。如果禁用身份验证，则XHR_AUTH_NONE。如果只应为代理身份验证启用身份验证，则XHR_AUTH_PROXY。
XHR_PROP_TIMEOUT	应用在超时之前等待的毫秒数，最多为 0xFFFFFFFF。
XHR_PROP_NO_DEFAULT_HEADERS	FALSE (0x0) 启用添加默认标头 (默认) 。 TRUE (0x1) 禁用添加默认标头。
XHR_PROP_REPORT_REDIRECT_STATUS	FALSE (0x0) 不报告重定向状态 (默认) 。 TRUE (0x1) 报告重定向状态。
XHR_PROP_NO_CACHE	FALSE (0x0) 启用默认 ) (缓存。 TRUE (0x1) 禁用缓存。
XHR_PROP_EXTENDED_ERROR	FALSE (0x0) 不 ( 默认) 提供扩展错误。 TRUE (0x1) 提供扩展错误。
XHR_PROP_QUERY_STRING_UTF8	FALSE (0x0) 不对 UTF-8 中的查询字符串进行编码， (默认) 。 TRUE (0x1) 对 UTF-8 中的查询字符串进行编码。
XHR_PROP_IGNORE_CERT_ERRORS	FALSE (0x0) 不忽略默认) (证书错误。 TRUE (0x1) 忽略证书错误。

如果成功，则返回 S_OK。

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 [桌面应用 \|UWP 应用]，MSXML 6.0 及更高版本
最低受支持的服务器	Windows Server 2012 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	msxml6.h