包含选项的值。
语法
typedef struct {
DWORD dwOption;
union {
DWORD dwValue;
LPWSTR pszValue;
FILETIME ftValue;
} Value;
} INTERNET_PER_CONN_OPTIONW, *LPINTERNET_PER_CONN_OPTIONW;
成员
dwOption
要查询或设置的选项。 此成员可以是以下值之一。
| 价值 |
意义 |
-
INTERNET_PER_CONN_AUTOCONFIG_URL
|
设置或检索包含自动配置脚本 URL 的字符串。
|
-
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS
|
设置或检索自动发现设置。
值 成员将包含以下一个或多个值:
- AUTO_PROXY_FLAG_ALWAYS_DETECT
-
始终自动检测设置。
- AUTO_PROXY_FLAG_CACHE_INIT_RUN
-
指示应使用自动代理配置脚本的缓存结果,而不是实际运行脚本,除非缓存的文件已过期。
- AUTO_PROXY_FLAG_DETECTION_RUN
-
自动检测已在此连接上运行至少一次。
- AUTO_PROXY_FLAG_DETECTION_SUSPECT
-
目前不支持。
- AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT
-
不允许缓存自动代理配置脚本的结果。
- AUTO_PROXY_FLAG_MIGRATED
-
此设置已从 Microsoft Internet Explorer 4.0 安装迁移,应尝试自动检测一次。
- AUTO_PROXY_FLAG_USER_SET
-
用户已显式设置自动检测。
|
-
INTERNET_PER_CONN_FLAGS
|
设置或检索连接类型。
值 成员将包含以下一个或多个值:
- PROXY_TYPE_DIRECT
-
连接不使用代理服务器。
- PROXY_TYPE_PROXY
-
连接使用显式设置的代理服务器。
- PROXY_TYPE_AUTO_PROXY_URL
-
连接会下载并处理指定 URL 处的自动配置脚本。
- PROXY_TYPE_AUTO_DETECT
-
连接会自动检测设置。
|
-
INTERNET_PER_CONN_PROXY_BYPASS
|
设置或检索包含不使用代理服务器的 URL 的字符串。
|
-
INTERNET_PER_CONN_PROXY_SERVER
|
设置或检索包含代理服务器的字符串。
|
-
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL
|
链接的自动配置 URL。 当主自动配置 URL 指向为代理信息设置第二个自动配置 URL 的 INS 文件时使用。
|
-
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS
|
自动发现自动刷新自动配置 URL 之前的分钟数。
|
-
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME
|
只读选项。 返回使用自动发现找到最后一个已知良好的自动配置 URL 的时间。
|
-
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL
|
只读选项。 返回使用自动发现找到的最后一个已知良好 URL。
|
Windows 7 及更高版本:
支持 Internet Explorer 8 的客户端应使用 INTERNET_PER_CONN_FLAGS_UI查询连接类型。 如果此查询失败,则系统正在运行旧版 Internet Explorer,客户端应再次使用 INTERNET_PER_CONN_FLAGS进行查询。
使用 INTERNET_PER_CONN_FLAGS 还原连接类型,而不考虑 Internet Explorer 的版本。
| 价值 |
意义 |
-
INTERNET_PER_CONN_FLAGS_UI
|
设置或检索连接类型。
值 成员将包含以下一个或多个值:
- PROXY_TYPE_DIRECT
-
连接不使用代理服务器。
- PROXY_TYPE_PROXY
-
连接使用显式设置的代理服务器。
- PROXY_TYPE_AUTO_PROXY_URL
-
连接会下载并处理指定 URL 处的自动配置脚本。
- PROXY_TYPE_AUTO_DETECT
-
连接会自动检测设置。
|
Value
包含选项值的联合。 它可以是以下任一类型,具体取决于 dwOption的值:
dwValue
无符号长整数值。
pszValue
指向字符串值的指针。
ftValue
FILETIME 结构。
Value.dwValue
无符号长整数值。
Value.pszValue
指向字符串值的指针。
Value.ftValue
FILETIME 结构。
在 Internet Explorer 5 中,只有 InternetQueryOption 的 ANSI 版本,InternetSetOption 才能使用 INTERNET_PER_CONN_OPTION 结构。 Unicode 版本将在 Internet Explorer 的更高版本中支持 INTERNET_PER_CONN_OPTION 结构。
对于返回字符串的查询,InternetQueryOption 为结构的 pszValue 成员分配内存。 调用应用程序在使用字符串完成后,必须使用 GlobalFree 函数释放此内存。
注意
wininet.h 标头将INTERNET_PER_CONN_OPTION定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。
要求
| 要求 |
价值 |
|
最低支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
|
支持的最低服务器 |
Windows 2000 Server [仅限桌面应用] |
|
标头 |
wininet.h |
另请参阅
INTERNET_PER_CONN_OPTION_LIST
InternetQueryOption
InternetSetOption