INTERNET_PER_CONN_OPTIONA 结构 (wininet.h)

  • 项目

包含选项的值。

语法

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

成员

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

注解

在 Internet Explorer 5 中，只有 ANSI 版本的 InternetQueryOption 和 InternetSetOption 才能使用 INTERNET_PER_CONN_OPTION 结构。 Unicode 版本将在更高版本的 Internet Explorer 中支持 INTERNET_PER_CONN_OPTION 结构。

对于返回字符串的查询， InternetQueryOption 为结构的 pszValue 成员分配内存。 调用应用程序在使用完字符串后，必须使用 GlobalFree 函数释放此内存。

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (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