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
设置或检索自动发现设置。 成员将包含以下一个或多个值:
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 不支持服务器实现。 此外,不应从服务使用它。 对于服务器实现或服务,请使用 Microsoft Windows HTTP 服务(WinHTTP)
 

注意

wininet.h 标头将INTERNET_PER_CONN_OPTION定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

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

另请参阅

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption