WinHttpRequestOption

描述

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

C / C ++语法

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;

PowerBASIC 语法

%WinHttpRequestOption_UserAgentString = 0

%WinHttpRequestOption_URL = 1

%WinHttpRequestOption_URLCodePage = 2

%WinHttpRequestOption_EscapePercentInURL = 3

%WinHttpRequestOption_SslErrorIgnoreFlags = 4

%WinHttpRequestOption_SelectCertificate = 5

%WinHttpRequestOption_EnableRedirects = 6

%WinHttpRequestOption_UrlEscapeDisable = 7

%WinHttpRequestOption_UrlEscapeDisableQuery = 8

%WinHttpRequestOption_SecureProtocols = 9

%WinHttpRequestOption_EnableTracing = 10

%WinHttpRequestOption_RevertImpersonationOverSsl = 11

%WinHttpRequestOption_EnableHttpsToHttpRedirects = 12

%WinHttpRequestOption_EnablePassportAuthentication = 13

%WinHttpRequestOption_MaxAutomaticRedirects = 14

%WinHttpRequestOption_MaxResponseHeaderSize = 15

%WinHttpRequestOption_MaxResponseDrainSize = 16

%WinHttpRequestOption_EnableHttp1_1 = 17

%WinHttpRequestOption_EnableCertificateRevocationCheck = 18

常量

WinHttpRequestOption_UserAgentString

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

WinHttpRequestOption_URL

检索包含资源的URL的VARIANT。此值为只读;您不能使用此属性设置URL。直到打开方法被调用才能读取URL。此选项在完成发送方法以验证是否发生任何重定向后对URL进行检查非常有用。

WinHttpRequestOption_URLCodePage

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

WinHttpRequestOption_EscapePercentInURL

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

WinHttpRequestOption_SslErrorIgnoreFlags

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

错误	值
未知的认证机构（CA）或不受信任的根	&H0100
使用错误	&H0200
通用名称（CN）无效	&H1000
无效的日期或证书已过期	&H2000

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	&H0008
SSL 3.0	&H0020
传输层安全（TLS）1.0	&H0080

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

WinHttpRequestOption_EnableTracing

设置或检索一个VARIANT，指示是否启用跟踪。有关Microsoft Windows HTTP服务（WinHTTP）中的跟踪工具的更多信息，请参阅WinHTTP跟踪设备.

WinHttpRequestOption_RevertImpersonationOverSsl

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

WinHttpRequestOption_EnableHttpsToHttpRedirects

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

WinHttpRequestOption_EnablePassportAuthentication

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

WinHttpRequestOption_MaxAutomaticRedirects

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