Contains the value of an option.

Syntax

typedef struct {
  DWORD dwOption;
  union {
    DWORD dwValue;
    LPTSTR pszValue;
    FILETIME ftValue;
  } Value;
}INTERNET_PER_CONN_OPTION, *LPINTERNET_PER_CONN_OPTION;

Members

dwOption

Option to be queried or set. This member can be one of the following values.

Value	Meaning
INTERNET_PER_CONN_AUTOCONFIG_URL	Sets or retrieves a string containing the URL to the automatic configuration script.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	Sets or retrieves the automatic discovery settings. The Value member will contain one or more of the following values: AUTO_PROXY_FLAG_ALWAYS_DETECT Always automatically detect settings. AUTO_PROXY_FLAG_CACHE_INIT_RUN Indicates that the cached results of the automatic proxy configuration script should be used, instead of actually running the script, unless the cached file has expired. AUTO_PROXY_FLAG_DETECTION_RUN Automatic detection has been run at least once on this connection. AUTO_PROXY_FLAG_DETECTION_SUSPECT Not currently supported. AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT Do not allow the caching of the result of the automatic proxy configuration script. AUTO_PROXY_FLAG_MIGRATED The setting was migrated from a Microsoft Internet Explorer 4.0 installation, and automatic detection should be attempted once. AUTO_PROXY_FLAG_USER_SET The user has explicitly set the automatic detection.
INTERNET_PER_CONN_FLAGS	Sets or retrieves the connection type. The Value member will contain one or more of the following values: PROXY_TYPE_DIRECT The connection does not use a proxy server. PROXY_TYPE_PROXY The connection uses an explicitly set proxy server. PROXY_TYPE_AUTO_PROXY_URL The connection downloads and processes an automatic configuration script at a specified URL. PROXY_TYPE_AUTO_DETECT The connection automatically detects settings.
INTERNET_PER_CONN_PROXY_BYPASS	Sets or retrieves a string containing the URLs that do not use the proxy server.
INTERNET_PER_CONN_PROXY_SERVER	Sets or retrieves a string containing the proxy servers.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	Chained autoconfig URL. Used when the primary autoconfig URL points to an INS file that sets a second autoconfig URL for proxy information.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	of minutes until automatic refresh of autoconfig URL by autodiscovery.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	Read only option. Returns the time the last known good autoconfig URL was found using autodiscovery.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	Read only option. Returns the last known good URL found using autodiscovery.

 

Value

Union that contains the value for the option. It can be any one of the following types depending the value of dwOption:

dwValue

Unsigned long integer value.

pszValue

Pointer to a string value.

ftValue

A FILETIME structure.

Remarks

In Internet Explorer 5, only the ANSI versions of InternetQueryOption and InternetSetOption will work with the INTERNET_PER_CONN_OPTION structure. The Unicode versions will support the INTERNET_PER_CONN_OPTION structure in later versions of Internet Explorer.

For queries that return strings, InternetQueryOption allocates the memory for the pszValue member of the structure. The calling application must free this memory using the GlobalFree function when it has finished using the string.

Requirements

See Also

InternetQueryOption

InternetSetOption

INTERNET_PER_CONN_OPTION_LIST

Send comments about this topic to Microsoft

Build date: 11/19/2009