INTERNET_PER_CONN_OPTIONW 结构 (wininet.h)
包含选项的值。
语法
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
|
设置或检索自动发现设置。 Value 成员将包含以下一个或多个值:
- 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
|
设置或检索连接类型。 Value 成员将包含以下一个或多个值:
- 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
|
设置或检索连接类型。 Value 成员将包含以下一个或多个值:
- 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 中,只有 ANSI 版本的 InternetQueryOption 和 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