选项标志 (Wininet.h)

项目
06/13/2023

以下选项标志用于 InternetQueryOption 和 InternetSetOption 函数。所有有效选项标志的值都大于或等于 INTERNET_FIRST_OPTION 且小于或等于 INTERNET_LAST_OPTION。

INTERNET_OPTION_ALTER_IDENTITY

80
未实现

INTERNET_OPTION_ASYNC

30
未实现。

INTERNET_OPTION_ASYNC_ID

15
未实现。

INTERNET_OPTION_ASYNC_PRIORITY

16
未实现。

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64
设置或检索布尔值，该值确定系统是否应检查网络以获取较新的内容，并在找到较新版本时覆盖已编辑的缓存条目。如果设置为 True，系统将检查网络中是否有较新的内容，并使用较新版本覆盖编辑的缓存条目。默认值为 False，指示应在不检查网络的情况下使用已编辑的缓存项。 InternetQueryOption 和 InternetSetOption 使用它。它仅在 Microsoft Internet Explorer 5 及更高版本中有效。

INTERNET_OPTION_CACHE_STREAM_HANDLE

27
不再支持。

INTERNET_OPTION_CACHE_TIMESTAMPS

69
从 Internet 缓存中存储的资源检索包含 LastModified 时间和 Expires 时间的 INTERNET_CACHE_TIMESTAMPS 结构。此值由 InternetQueryOption 使用。

INTERNET_OPTION_CALLBACK

1
设置或检索为此句柄定义的回调函数的地址。此选项可用于所有 HINTERNET 句柄。由 InternetQueryOption 和 InternetSetOption 使用。

INTERNET_OPTION_CALLBACK_FILTER

54
未实现。

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84
InternetQueryOption 不支持此标志。 lpBuffer 参数必须是指向CERT_CONTEXT结构的指针，而不是指向CERT_CONTEXT指针的指针。如果应用程序收到 ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED，则必须在重试请求之前调用 InternetErrorDlg 或使用 InternetSetOption 提供证书。然后调用 CertDuplicateCertificateContext，以便应用程序可以独立释放传递的证书上下文。

INTERNET_OPTION_CODEPAGE

68
默认情况下，Unicode URL 的主机或颁发机构部分根据 IDN 规范进行编码。禁用 IDN 时，在请求或连接句柄上设置此选项会为 URL 的主机部分指定代码页编码方案。 InternetSetOption 调用中的 lpBuffer 参数包含所需的 DBCS 代码页。如果未在 lpBuffer 中指定任何代码页，WinINet 将使用默认的系统代码页 (CP_ACP) 。注意：如果未禁用 IDN，则忽略此选项。有关如何禁用 IDN 的详细信息，请参阅 INTERNET_OPTION_IDN 选项。

Windows XP SP2 和 Windows Server 2003 SP1： 不支持此标志。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_CODEPAGE_PATH

100
默认情况下，URL 的路径部分采用 UTF8 编码。 WinINet API 对高位字符执行转义字符 (%) 编码。在请求或连接句柄上设置此选项会禁用 UTF8 编码并设置特定的代码页。对 InternetSetOption 的调用中的 lpBuffer 参数包含路径的所需 DBCS 代码页。如果未在 lpBuffer 中指定任何代码页，WinINet 将使用默认CP_UTF8。

Windows XP SP2 和 Windows Server 2003 SP1： 不支持此标志。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_CODEPAGE_EXTRA

101
默认情况下，URL 的路径部分是默认系统代码页 (CP_ACP) 。转义字符 (%) 转换不对额外部分执行。在请求或连接句柄上设置此选项会禁用CP_ACP编码。调用 InternetSetOption 中的 lpBuffer 参数包含 URL 额外部分所需的 DBCS 代码页。如果未在 lpBuffer 中指定任何代码页，WinINet 将使用默认的系统代码页 (CP_ACP) 。

Windows XP SP2 和 Windows Server 2003 SP1： 不支持此标志。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147
对于 WinInet 解压缩服务器提供的内容编码的请求，检索服务器报告的响应正文的 Content-Length 作为 ULONGLONG。在 Windows 10 版本 1507 及更高版本中受支持。

INTERNET_OPTION_CONNECT_BACKOFF

4
未实现。

INTERNET_OPTION_CONNECT_RETRIES

3
设置或检索一个无符号长整数值，该值包含 WinINet 尝试解析和连接到主机的次数。每个 IP 地址只尝试一次。例如，如果尝试连接到具有 10 个 IP 地址且INTERNET_OPTION_CONNECT_RETRIES设置为 7 的多宿主主机，则 WinINet 仅尝试解析并连接到前七个 IP 地址。相反，如果同一组十个 IP 地址设置为 20，则如果INTERNET_OPTION_CONNECT_RETRIES设置为 20，WinINet 只尝试这十个地址中的每一个地址一次。如果主机只有一个 IP 地址，且尝试首次连接失败，则不再进行尝试。如果在执行指定的尝试次数后连接尝试仍失败，则会取消该请求。 INTERNET_OPTION_CONNECT_RETRIES的默认值为五次尝试。此选项可用于任何 HINTERNET 句柄，包括 NULL 句柄。它由 InternetQueryOption 和 InternetSetOption 使用。

INTERNET_OPTION_CONNECT_TIME

55
未实现。

INTERNET_OPTION_CONNECT_TIMEOUT

2
设置或检索一个无符号长整数值，该值包含要用于 Internet 连接请求的超时值（以毫秒为单位）。将此选项设置为无限 (0xFFFFFFFF) 将禁用此计时器。

如果连接请求花费的时间超过此超时值，则会取消该请求。尝试连接到单个主机 (多宿主主机) 的多个 IP 地址时，所有 IP 地址的超时限制是累积的。此选项可用于任何 HINTERNET 句柄，包括 NULL 句柄。它由 InternetQueryOption 和 InternetSetOption 使用。

INTERNET_OPTION_CONNECTED_STATE

50
设置或检索包含连接状态的无符号长整数值。 InternetQueryOption 和 InternetSetOption 使用它。

INTERNET_OPTION_CONTEXT_VALUE

45
设置或检索包含与此 HINTERNET 句柄关联的上下文值的地址的DWORD_PTR。此选项可用于任何 HINTERNET 句柄。 InternetQueryOption 和 InternetSetOption 使用它。以前，这会将上下文值设置为 lpBuffer 指针中存储的地址。此问题已更正，以便使用存储在缓冲区中的值，并为 INTERNET_OPTION_CONTEXT_VALUE 标志分配一个新值。旧值 10 已保留，因此仍支持为旧行为编写的应用程序。

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6
与 INTERNET_OPTION_RECEIVE_TIMEOUT相同。 InternetQueryOption 和 InternetSetOption 使用它。

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5
与 INTERNET_OPTION_SEND_TIMEOUT相同。 InternetQueryOption 和 InternetSetOption 使用它。

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8
设置或检索一个无符号长整数值，该值包含超时值（以毫秒为单位），以接收对 FTP 事务的数据通道请求的响应。如果响应时间超过此超时值，则取消该请求。此选项可用于任何 HINTERNET 句柄，包括 NULL 句柄。它由 InternetQueryOption 和 InternetSetOption 使用。

此标志对 HTTP 功能没有影响。

INTERNET_OPTION_DATA_SEND_TIMEOUT

7
设置或检索一个无符号长整数值（以毫秒为单位），该值包含用于发送 FTP 事务的数据通道请求的超时值。如果发送时间超过此超时值，则取消发送。此选项可用于任何 HINTERNET 句柄，包括 NULL 句柄。它由 InternetQueryOption 和 InternetSetOption 使用。

此标志对 HTTP 功能没有影响。

INTERNET_OPTION_DATAFILE_NAME

33
检索一个字符串值，该值包含支持已下载实体的文件的名称。此标志在 InternetOpenUrl、 FtpOpenFile、 GopherOpenFile 或 HttpOpenRequest 完成后有效。只能通过 InternetQueryOption 查询此选项。

INTERNET_OPTION_DATAFILE_EXT

96
设置一个字符串值，该值包含支持已下载实体的文件的扩展名。应在调用 InternetOpenUrl、 FtpOpenFile、 GopherOpenFile 或 HttpOpenRequest 之前设置此标志。此选项只能由 InternetSetOption 设置。

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67
检索包含有关指定 HTTP 请求的数据 的INTERNET_DIAGNOSTIC_SOCKET_INFO 结构。 InternetQueryOption 使用此标志。

Windows 7： 不再支持此选项。

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76
导致系统注销摘要式身份验证 SSPI 包，清除为进程创建的所有凭据。此选项不需要缓冲区。 InternetSetOption 使用它。

INTERNET_OPTION_DISABLE_AUTODIAL

70
未实现。

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49
未实现。

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148
设置可接受的高级 HTTP 版本的 DWORD 位掩码。可以在任何句柄类型上设置。可能的值为： HTTP_PROTOCOL_FLAG_HTTP2 (0x2) 。在 Windows 10 版本 1507 及更高版本上受支持。 无法使用此选项禁用旧版 HTTP (1.1 和以前的) 。默认值为 0x0。在 Windows 10 版本 1507 及更高版本中受支持。

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122
在请求句柄上，设置一个布尔值，控制是否将从给定请求的 WinInet 缓存返回重定向。默认值为 FALSE。在 Windows 8 及更高版本中受支持。

INTERNET_OPTION_ENCODE_EXTRA

155
获取/设置一个 BOOL，该值指示查询字符串中的非 ASCII 字符是否应进行百分比编码。默认值为 FALSE。在 Windows 8.1 及更高版本中受支持。

INTERNET_OPTION_END_BROWSER_SESSION

42
从硬盘驱动器上的密码缓存刷新未使用的条目。还重置同步模式为每个会话一次时使用的缓存时间。此选项不需要缓冲区。 InternetSetOption 使用它。

INTERNET_OPTION_ERROR_MASK

62
设置一个无符号长整数值，该值包含可由客户端应用程序处理的错误掩码。这可以是以下值的组合：

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

指示将使用相同的错误返回报告所有证书错误，即 ERROR_INTERNET_SEC_CERT_ERRORS。如果设置了此标志，请在收到ERROR_INTERNET_SEC_CERT_ERRORS错误时调用 InternetErrorDlg，以便用户可以响应描述该问题的熟悉对话。

注意

未能通知用户此错误会使用户面临潜在的欺骗攻击。

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

指示客户端应用程序可以处理 ERROR_INTERNET_INSERT_CDROM 错误代码。

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

指示客户端应用程序可以处理 ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY 错误代码。

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

未实现。

INTERNET_OPTION_ENTERPRISE_CONTEXT

159
设置包含企业 ID 的 PWSTR， (请参阅 https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx 适用于请求) 。在 Windows 10 版本 1507 及更高版本中受支持。

INTERNET_OPTION_EXTENDED_ERROR

24
检索一个无符号长整数值，该值包含映射到此线程上下文中上次返回 ERROR_INTERNET_ 错误消息的 Winsock 错误代码。此选项在 InternetQueryOption 的 NULLHINTERNET 句柄上使用。

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63
设置或检索一个 1n 无符号长整数值，该值包含系统在检查缓存中是否有资源副本之前应等待网络请求响应的时间。如果网络请求花费的时间超过指定的时间，并且请求的资源在缓存中可用，则会从缓存中检索该资源。 InternetQueryOption 和 InternetSetOption 使用它。

INTERNET_OPTION_HANDLE_TYPE

9
检索包含传入的 HINTERNET 句柄类型的无符号长整数值。这由 InternetQueryOption 在任何 HINTERNET 句柄上使用。可能的返回值包括以下内容。

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157
获取/设置一个 BOOL，该值指示 WinInet 是否应遵循来自服务器的 HTTP 严格传输安全 (HSTS) 指令。如果启用，对具有 WinInet 缓存的 HSTS 策略的域的 https:// 计划请求将被重定向到匹配 https:// URL。默认值为 FALSE。在 Windows 8.1 及更高版本中受支持。

INTERNET_OPTION_HTTP_DECODING

65
使 WinINet 能够对 gzip 和 deflate 编码方案执行解码。有关详细信息，请参阅 内容编码。

INTERNET_OPTION_HTTP_PROTOCOL_USED

149
获取一个 DWORD，该 DWORD 指示在给定请求上使用的高级 HTTP 版本。可能的值为： HTTP_PROTOCOL_FLAG_HTTP2 (0x2) 。在 Windows 10 版本 1507 及更高版本上受支持。 0x0指示 HTTP/1.1 或更早版本;如果需要更精确地了解使用了哪个旧版本，请参阅 INTERNET_OPTION_HTTP_VERSION。在 Windows 10 版本 1507 及更高版本上受支持。

INTERNET_OPTION_HTTP_VERSION

59
设置或检索包含支持的 HTTP 版本的 HTTP_VERSION_INFO 结构。这必须在 NULL 句柄上使用。 InternetQueryOption 和 InternetSetOption 使用它。

在 Windows 7、Windows Server 2008 R2 及更高版本中，HTTP_VERSION_INFO 结构中的 dwMinorVersion 成员的值被 Internet Explorer 设置覆盖。 EnableHttp1_1 是 HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE 下的注册表值，由 Internet Explorer 中为系统设置的 Internet 选项控制。 EnableHttp1_1值默认为 1。如果 EnableHttp1_1 设置为 1，则对于任何低于 1.1 的 HTTP 版本 ，将忽略HTTP_VERSION_INFO 结构。

INTERNET_OPTION_IDENTITY

78
未实现。

INTERNET_OPTION_IDLE_STATE

51
未实现。

INTERNET_OPTION_IDN

102
默认情况下，URL 的主机或颁发机构部分根据直接连接和代理连接的 IDN 规范进行编码。此选项可用于请求或连接句柄来启用或禁用 IDN。禁用 IDN 后，WinINet 使用系统代码页对 URL 的主机或颁发机构部分进行编码。若要禁用 IDN 主机转换，请在对 InternetSetOption 的调用中将 lpBuffer 参数设置为零。若要仅在直接连接上启用 IDN 转换，请在 InternetSetOption 调用的 lpBuffer 参数中指定INTERNET_FLAG_IDN_DIRECT。若要仅在代理连接上启用 IDN 转换，请在 InternetSetOption 调用的 lpBuffer 参数中指定INTERNET_FLAG_IDN_PROXY。

Windows XP SP2 和 Windows Server 2003 SP1： 不支持此标志。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_IGNORE_OFFLINE

77
设置或检索是否应忽略指定请求句柄的全局脱机标志。此选项不需要缓冲区。 InternetQueryOption 和 InternetSetOption 使用请求句柄。此选项仅在 Internet Explorer 5 及更高版本中有效。

INTERNET_OPTION_KEEP_CONNECTION

22
未实现。

INTERNET_OPTION_LISTEN_TIMEOUT

11
未实现。

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74
设置或检索一个无符号长整数值，该值包含每个 HTTP/1.0 服务器允许的最大连接数。 InternetQueryOption 和 InternetSetOption 使用它。此选项仅在 Internet Explorer 5 及更高版本中有效。

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103
设置或检索一个无符号长整数值，该值包含每个 CERN 代理允许的最大连接数。设置或检索此选项时， hInternet 参数必须设置为 null 句柄值。 null 句柄值指示应为当前进程设置或查询选项。使用此选项调用 InternetSetOption 时，所有现有代理对象都将接收新值。此值限制为 2 到 128（含 2 到 128）。

版本： 需要 Internet Explorer 8.0。

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73
设置或检索一个无符号长整数值，该值包含每个服务器允许的最大连接数。 InternetQueryOption 和 InternetSetOption 使用它。此选项仅在 Internet Explorer 5 及更高版本中有效。

INTERNET_OPTION_OFFLINE_MODE

26
未实现。

INTERNET_OPTION_OFFLINE_SEMANTICS

52
未实现。

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176
选择加入弱签名 (例如 SHA-1) 被视为不安全。这将指示 WinInet 使用 CERT_CHAIN_OPT_IN_WEAK_SIGNATURE 参数调用 CertGetCertificateChain。

INTERNET_OPTION_PARENT_HANDLE

21
检索此句柄的父句柄。此选项可以在 InternetQueryOption 的任何 HINTERNET 句柄上使用。

INTERNET_OPTION_PASSWORD

29
设置或检索一个字符串值，该值包含与 InternetConnect 返回的句柄关联的密码。 InternetQueryOption 和 InternetSetOption 使用它。

INTERNET_OPTION_PER_CONNECTION_OPTION

75
设置或检索 INTERNET_PER_CONN_OPTION_LIST 结构，该结构指定特定连接的选项列表。 InternetQueryOption 和 InternetSetOption 使用它。此选项仅在 Internet Explorer 5 及更高版本中有效。

注意

INTERNET_OPTION_PER_CONNECTION_OPTION会导致在调用 InternetSetOption 时，在系统范围内更改设置。若要刷新全局代理设置，必须使用 INTERNET_OPTION_REFRESH 选项标志调用 InternetSetOption。

注意

若要更改整个过程的代理信息而不影响 Internet Explorer 5 及更高版本中的全局设置，请在从 InternetOpen 返回的句柄上使用此选项。下面的代码示例更改了整个过程的代理，即使 HINTERNET 句柄已关闭且未由任何请求使用。

INTERNET_OPTION_POLICY

48
未实现。

INTERNET_OPTION_PROXY

38
当 HINTERNET 句柄不为 NULL 时，设置或检索包含现有 InternetOpen 句柄的代理数据的INTERNET_PROXY_INFO结构。如果 HINTERNET 句柄为 NULL，则该函数将设置或查询全局代理数据。此选项可用于 InternetOpen 返回的句柄。它由 InternetQueryOption 和 InternetSetOption 使用。

注意

建议使用INTERNET_OPTION_PER_CONNECTION_OPTION而不是INTERNET_OPTION_PROXY。

INTERNET_OPTION_PROXY_PASSWORD

44
设置或检索包含用于访问代理的密码的字符串值。 InternetQueryOption 和 InternetSetOption 使用它。可以在 InternetConnect 或 HttpOpenRequest 返回的句柄上设置此选项。

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95
提醒当前 WinInet 实例代理设置已更改，并且必须使用新设置进行更新。若要为所有可用的 WinInet 实例发出警报，请在传递此选项时将 InternetSetOption 的 Buffer 参数设置为 NULL，并将 BufferLength 设置为 0。可以在 InternetConnect 或 HttpOpenRequest 返回的句柄上设置此选项。

INTERNET_OPTION_PROXY_USERNAME

43
设置或检索包含用于访问代理的用户名的字符串值。 InternetQueryOption 和 InternetSetOption 使用它。可以在 InternetConnect 或 HttpOpenRequest 返回的句柄上设置此选项。

INTERNET_OPTION_READ_BUFFER_SIZE

12
设置或检索包含读取缓冲区大小的无符号长整数值。此选项可用于 FtpOpenFile、FtpFindFirstFile 和 InternetConnect 返回的 HINTERNET 句柄 (仅) FTP 会话。此选项由 InternetQueryOption 和 InternetSetOption 使用。

INTERNET_OPTION_RECEIVE_THROUGHPUT

57
未实现。

INTERNET_OPTION_RECEIVE_TIMEOUT

6
设置或检索一个无符号长整数值，该值包含超时值（以毫秒为单位）以接收对请求的响应。如果响应时间超过此超时值，则取消该请求。此选项可用于任何 HINTERNET 句柄，包括 NULL 句柄。它由 InternetQueryOption 和 InternetSetOption 使用。

此选项不用于表示精细的即时超时。可以预期超时在设置超时值后最多 6 秒发生。

在引用 FTP 事务时，此选项引用控制通道。

INTERNET_OPTION_REFRESH

37
导致从句柄的注册表中重新读取代理数据。不需要缓冲区。此选项可用于 InternetOpen 返回的 HINTERNET 句柄。 InternetSetOption 使用它。

INTERNET_OPTION_REMOVE_IDENTITY

79
未实现。

INTERNET_OPTION_REQUEST_FLAGS

23
检索一个无符号长整数值，该值包含指示正在进行的下载状态的特殊状态标志。 InternetQueryOption 使用此方法。 INTERNET_OPTION_REQUEST_FLAGS选项可以是以下值之一：

INTERNET_REQFLAG_ASYNC

0x00000002

未实现。

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

不能 (HTTPS 请求（例如，) ）缓存 Internet 请求。

INTERNET_REQFLAG_FROM_CACHE

0x00000001

响应来自缓存。

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

Internet 请求超时。

INTERNET_REQFLAG_NO_HEADERS

0x00000008

原始响应不包含标头。

INTERNET_REQFLAG_PASSIVE

0x00000010

未实现。

INTERNET_REQFLAG_VIA_PROXY

0x00000004

请求是通过代理发出的。

INTERNET_OPTION_REQUEST_PRIORITY

58
设置或检索一个无符号长整数值，该值包含争用 HTTP 句柄上的连接的请求的优先级。 InternetQueryOption 和 InternetSetOption 使用它。

INTERNET_OPTION_RESET_URLCACHE_SESSION

60
为进程启动新的缓存会话。不需要缓冲区。 InternetSetOption 使用它。此选项仅供内部使用。

INTERNET_OPTION_SECONDARY_CACHE_KEY

53
设置或检索包含辅助缓存密钥的字符串值。 InternetQueryOption 和 InternetSetOption 使用它。此选项仅供内部使用。

INTERNET_OPTION_SECURITY_CERTIFICATE

35
将 SSL/PCT (安全套接字层/专用通信技术) 服务器的证书检索为格式化字符串。 InternetQueryOption 使用此方法。

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32
将 SSL/PCT 服务器的证书检索到INTERNET_CERTIFICATE_INFO结构中。 InternetQueryOption 使用此方法。

INTERNET_OPTION_SECURITY_FLAGS

31
检索包含句柄的安全标志的无符号长整数值。 InternetQueryOption 使用此选项。它可以是以下值的组合。

SECURITY_FLAG_128BIT

0x20000000

与首选值SECURITY_FLAG_STRENGTH_STRONG相同。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_40BIT

0x10000000

与首选值SECURITY_FLAG_STRENGTH_WEAK相同。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_56BIT

0x40000000

与首选值SECURITY_FLAG_STRENGTH_MEDIUM相同。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_FORTEZZA

0x08000000

指示 Fortezza 已用于为指定的连接提供保密性、身份验证和/或完整性。

SECURITY_FLAG_IETFSSL4

0x00000020

未实现。

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

忽略 ERROR_INTERNET_SEC_CERT_CN_INVALID 错误消息。

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

忽略 ERROR_INTERNET_SEC_CERT_DATE_INVALID 错误消息。

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

忽略 ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR 错误消息。

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

忽略 ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR 错误消息。

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

忽略证书吊销问题。

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

忽略未知的证书颁发机构问题。

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

忽略弱证书签名问题。

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

忽略不正确的使用问题。

SECURITY_FLAG_NORMALBITNESS

0x10000000

与值SECURITY_FLAG_STRENGTH_WEAK相同。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_PCT

0x00000008

未实现。

SECURITY_FLAG_PCT4

0x00000010

未实现。

SECURITY_FLAG_SECURE

0x00000001

使用安全传输。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_SSL

0x00000002

未实现。

SECURITY_FLAG_SSL3

0x00000004

未实现。

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

使用中等 (56 位) 加密。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

使用强 (128 位) 加密。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

使用弱 (40 位) 加密。这仅在对 InternetQueryOption 的调用中返回。

SECURITY_FLAG_UNKNOWNBIT

0x80000000

加密中使用的位大小未知。这仅在对 InternetQueryOption 的调用中返回。

请注意，以这种方式检索的数据与已发生的事务相关，该事务的安全级别无法再更改。

INTERNET_OPTION_SECURITY_KEY_BITNESS

36
检索包含加密密钥的位大小的无符号长整数值。数字越大，使用的加密强度就越大。 InternetQueryOption 使用此方法。请注意，以这种方式检索的数据与已发生的事务相关，该事务的安全级别无法再更改。

INTERNET_OPTION_SEND_THROUGHPUT

56
未实现。

INTERNET_OPTION_SEND_TIMEOUT

5
设置或检索一个无符号长整数值（以毫秒为单位），该值包含用于发送请求的超时值。如果发送时间超过此超时值，则取消发送。此选项可用于任何 HINTERNET 句柄，包括 NULL 句柄。它由 InternetQueryOption 和 InternetSetOption 使用。

在引用 FTP 事务时，此选项引用控制通道。

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105
检索服务器证书链上下文作为重复 PCCERT_CHAIN_CONTEXT。可以将此重复的上下文传递给采用 PCCERT_CHAIN_CONTEXT的任何 Crypto API 函数。使用完证书链上下文后，必须对返回PCCERT_CHAIN_CONTEXT调用 CertFreeCertificateChain。

版本： 需要 Internet Explorer 8.0。

INTERNET_OPTION_SETTINGS_CHANGED

39
通知系统注册表设置已更改，以便它在下次调用 InternetConnect 时验证设置。 InternetSetOption 使用它。

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104
设置 HTTP 请求对象，使其不会登录到源服务器，但会执行 HTTP 代理服务器的自动登录。此选项不同于 请求标志INTERNET_FLAG_NO_AUTH，后者会阻止对代理服务器和源服务器的身份验证。

设置此模式将在与源服务器通信时禁止使用任何凭据材料 (以前提供的用户名/密码或客户端 SSL 证书) 。但是，如果请求必须通过身份验证代理传输，WinINet 仍将根据用户的 Intranet 区域设置对 HTTP 代理执行自动身份验证。默认 Intranet 区域设置是允许使用用户默认凭据自动登录。

为了确保抑制所有标识信息，调用方应 将INTERNET_OPTION_SUPPRESS_SERVER_AUTH 与 INTERNET_FLAG_NO_COOKIES 请求标志组合在一起。

此选项只能在请求对象发送之前对其进行设置。发送请求后尝试设置此选项将返回 ERROR_INTERNET_INCORRECT_HANDLE_STATE。

此选项不需要缓冲区。这仅由 InternetSetOption 对 HttpOpenRequest 返回的句柄使用。

版本： 需要 Internet Explorer 8.0 或更高版本。

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81
一个常规用途选项，用于在进程范围内抑制行为。函数的 lpBuffer 参数必须是指向包含要取消的特定行为的 DWORD 的指针。无法使用 InternetQueryOption 查询此选项。允许的值为：

INTERNET_SUPPRESS_RESET_ALL

0

禁用所有抑制，重新启用默认和配置的行为。此选项等效于单独设置 INTERNET_SUPPRESS_COOKIE_POLICY_RESET 和 INTERNET_SUPPRESS_COOKIE_PERSIST_RESET 。

版本： 需要 Internet Explorer 6.0 或更高版本。

INTERNET_SUPPRESS_COOKIE_POLICY

1

忽略任何配置的 Cookie 策略，并允许设置 Cookie。

版本： 需要 Internet Explorer 6.0 或更高版本。

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

禁用 INTERNET_SUPPRESS_COOKIE_POLICY 抑制，允许根据配置的 Cookie 策略评估 Cookie。

版本： 需要 Internet Explorer 6.0 或更高版本。

INTERNET_SUPPRESS_COOKIE_PERSIST

3

禁止保留 Cookie，即使服务器已将其指定为永久性。

版本： 需要 Internet Explorer 8.0 或更高版本。

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

禁用 INTERNET_SUPPRESS_COOKIE_PERSIST 抑制，重新启用 Cookie 的持久性。以前禁止使用的任何 Cookie 都不会成为永久性 Cookie。

版本： 需要 Internet Explorer 8.0 或更高版本。

INTERNET_OPTION_URL

34
检索包含已下载资源的完整 URL 的字符串值。如果原始 URL 包含任何额外的数据（例如搜索字符串或定位点），或者调用已重定向，则返回的 URL 与原始 URL 不同。此选项在 InternetOpenUrl、FtpOpenFile、GopherOpenFile 或 HttpOpenRequest 返回的 HINTERNET 句柄上有效。它由 InternetQueryOption 使用。

INTERNET_OPTION_USER_AGENT

41
设置或检索 由 InternetOpen 提供并在后续 HttpSendRequest 函数中使用的句柄上的用户代理字符串，只要它不会被 HttpAddRequestHeaders 或 HttpSendRequest 添加的标头覆盖。 InternetQueryOption 和 InternetSetOption 使用此功能。

INTERNET_OPTION_USERNAME

28
设置或检索包含与 InternetConnect 返回的句柄关联的用户名的字符串。 InternetQueryOption 和 InternetSetOption 使用此功能。

INTERNET_OPTION_VERSION

40
检索包含 Wininet.dll 版本号的INTERNET_VERSION_INFO结构。此选项可以通过 InternetQueryOption 在 NULLHINTERNET 句柄上使用。

INTERNET_OPTION_WRITE_BUFFER_SIZE

13
设置或检索包含写入缓冲区大小（以字节为单位）的无符号长整数值。此选项可用于 FtpOpenFile 和 InternetConnect 返回的 HINTERNET 句柄 (仅) FTP 会话。 InternetQueryOption 和 InternetSetOption 使用它。

备注

注意

WinINet 不支持服务器实现。此外，不应从服务使用它。对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Wininet.h; Winineti.h

选项标志 (Wininet.h)

备注

要求

反馈

反馈

其他资源