Export (0) Print
Expand All
2 out of 6 rated this helpful - Rate this topic

INTERNET_PER_CONN_OPTION structure

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.

ValueMeaning
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.

 

Windows 7 and later:  

Clients that support Internet Explorer 8 should query the connection type using INTERNET_PER_CONN_FLAGS_UI. If this query fails, then the system is running a previous version of Internet Explorer and the client should query again with INTERNET_PER_CONN_FLAGS.

Restore the connection type using INTERNET_PER_CONN_FLAGS regardless of the version of Internet Explorer.

ValueMeaning
INTERNET_PER_CONN_FLAGS_UI

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.

 

Value

Union that contains the value for the option. It can be any one of the following types depending on 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.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Unicode and ANSI names

INTERNET_PER_CONN_OPTIONW (Unicode) and INTERNET_PER_CONN_OPTIONA (ANSI)

See also

InternetQueryOption
InternetSetOption
INTERNET_PER_CONN_OPTION_LIST

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.