WinHttpRequestOption 枚举

WinHttpRequestOption 枚举包括可为当前Microsoft Windows HTTP 服务（WinHTTP）会话设置或检索的选项。

语法

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

常量

WinHttpRequestOption_UserAgentString

设置或检索包含用户代理字符串的 VARIANT。

WinHttpRequestOption_URL

检索包含资源的 URL 的 VARIANT 。此值为只读;不能使用此属性设置 URL。在调用 Open 方法之前，无法读取 URL。此选项可用于在 Send 方法完成后检查 URL，以验证是否发生了任何重定向。

WinHttpRequestOption_URLCodePage

设置或检索标识 URL 字符串的代码页的 VARIANT。默认值为 UTF-8 代码页。代码页用于将 Open 方法中传递的 Unicode URL 字符串转换为单字节字符串表示形式。

WinHttpRequestOption_EscapePercentInURL

设置或检索一个 VARIANT ，该值指示 URL 字符串中的百分比字符是否转换为转义序列。此选项的默认值 为VARIANT_TRUE ，它指定除百分比符号转换为转义序列之外的所有不安全的美国国家标准研究所（ANSI）字符。

WinHttpRequestOption_SslErrorIgnoreFlags

设置或检索一个 VARIANT ，该值指示应忽略哪些服务器证书错误。这可以是以下一个或多个标志的组合。

错误	价值
未知证书颁发机构（CA）或不受信任的根	0x0100
使用错误	0x0200
公用名无效（CN）	0x1000
无效日期或证书已过期	0x2000

WinHTTP 版本 5.1 中此选项的默认值为零，这不会忽略任何错误。在早期版本的 WinHTTP 中，默认设置是0x3300，导致默认忽略所有服务器证书错误。

WinHttpRequestOption_SelectCertificate

设置一个 VARIANT ，指定发送到服务器的客户端证书进行身份验证。此选项指示用反斜杠分隔的客户端证书的位置、 证书存储和使用者。有关选择客户端证书的详细信息，请参阅 WinHTTP 中的 SSL。

WinHttpRequestOption_EnableRedirects

设置或检索一个 VARIANT 类型的值 ，该值指示在服务器为资源指定新位置时是否自动重定向请求。此选项的默认值 为VARIANT_TRUE ，指示请求会自动重定向。

WinHttpRequestOption_UrlEscapeDisable

设置或检索一个 VARIANT 类型的值，该值指示是否将 URL 的路径和查询组件中的不安全字符转换为转义序列。此选项的默认值 为VARIANT_TRUE，指定转换路径和查询中的字符。

WinHttpRequestOption_UrlEscapeDisableQuery

设置或检索一个 VARIANT ，该值指示是否将 URL 的查询组件中的不安全字符转换为转义序列。此选项的默认值 为VARIANT_TRUE，指定转换查询中的字符。

WinHttpRequestOption_SecureProtocols

设置或检索一个 VARIANT ，该值指示可以使用哪些安全协议。此选项选择客户端可接受的协议。协议是在安全套接字层（SSL）握手期间协商的。这可以是以下一个或多个标志的组合。

协议	价值
SSL 2.0	0x0008
SSL 3.0	0x0020
传输层安全性 (TLS) 1.0	0x0080

此选项的默认值为0x0028，指示可以使用 SSL 2.0 或 SSL 3.0。如果此选项设置为零，则客户端和服务器无法确定可接受的安全协议，下一次发送会导致错误。

WinHttpRequestOption_EnableTracing

设置或检索指示当前是否启用跟踪的 VARIANT 。另请参阅收集 WinHTTP 跟踪。

WinHttpRequestOption_RevertImpersonationOverSsl

控制 WinHttpRequest 对象是否在 SSL 证书身份验证作期间临时还原客户端模拟。 WinHttpRequest 对象的默认设置为 TRUE。将此选项设置为 FALSE ，以在执行证书身份验证作时保持模拟。

WinHttpRequestOption_EnableHttpsToHttpRedirects

控制 WinHTTP 是否允许重定向。默认情况下，所有重定向都会自动遵循，但从安全（https） URL 传输到非安全（http） URL 的重定向除外。将此选项设置为 TRUE 以启用 HTTPS 到 HTTP 重定向。

WinHttpRequestOption_EnablePassportAuthentication

启用或禁用对 Passport 身份验证的支持。默认情况下，禁用对 Passport 身份验证的自动支持;将此选项设置为 TRUE 以启用 Passport 身份验证支持。

WinHttpRequestOption_MaxAutomaticRedirects

设置或检索 WinHTTP 遵循的最大重定向数;默认值为 10。此限制可防止未经授权的站点在大量重定向后使 WinHTTP 客户端停止。