WinHttpRequestOption 枚举

项目
06/03/2023

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 ，指示应忽略哪些服务器证书错误。这可以是以下一个或多个标志的组合。

错误	Value
未知证书颁发机构 (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 客户端停止。