Share via


RSOP_IEConnectionSettings class

Represents the details of an Internet connection that is made by using Microsoft Internet Explorer (IE), including details related to auto-configuration. Auto-configuration is a process that administrators can use to update IE settings. The class is used to report RSOP.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[AMENDMENT]
class RSOP_IEConnectionSettings : RSOP_IEProxySettings
{
  string  rsopID;
  uint32  rsopPrecedence;
  boolean enableProxy;
  boolean useSameProxy;
  string  httpProxyServer;
  string  proxyOverride;
  string  ftpProxyServer;
  string  gopherProxyServer;
  string  secureProxyServer;
  string  socksProxyServer;
  string  autoConfigURL;
  boolean autoConfigUseLocal;
  string  autoProxyURL;
  sint32  autoConfigTime;
  boolean autoDetectConfigSettings;
  boolean autoConfigEnable;
  boolean importCurrentConnSettings;
  boolean deleteExistingConnSettings;
  string  defaultDialUpConnection;
  uint8   dialUpState;
  string  dialUpConnections[];
};

Members

The RSOP_IEConnectionSettings class has these types of members:

Properties

The RSOP_IEConnectionSettings class has these properties.

autoConfigEnable

Data type: boolean

Access type: Read-only

Qualifiers: DisplayName ("Auto Configuration Enable")

If TRUE, the setting to use an automatic configuration script in the Internet Options utility in Control Panel is enabled. If FALSE, the setting is disabled. The setting is located in the Automatic Configuration area of the Local Area Network (LAN) Settings dialog box. To see the LAN Settings dialog box, users open the Internet Options dialog box, click the Connections tab, and then click the LAN Settings button.

autoConfigTime

Data type: sint32

Access type: Read-only

Qualifiers: DisplayName ("Auto Configuration Time")

The time when auto-configuration occurs, in minutes. A value of 0 (zero) indicates that auto-configuration occurs when the user starts Internet Explorer, and when the user navigates to a new Internet site.

autoConfigURL

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Auto Configuration URL")

File system path to the .ins file that contains the auto-configuration settings an administrator defines.

autoConfigUseLocal

Data type: boolean

Access type: Read-only

Qualifiers: DisplayName ("Auto Configuration Use Local")

If TRUE, indicates the .ins file that contains the auto-configuration settings is located on a local computer. If FALSE, the file is on a remote server.

autoDetectConfigSettings

Data type: boolean

Access type: Read-only

Qualifiers: DisplayName ("Auto Detect Configuration Settings")

If TRUE, the system uses automatic detection to configure dial-up settings for users. If FALSE, dial-up settings are not configured by Automatic Detection.

The Automatic Detection feature is based on Web Proxy AutoDiscovery (WPAD). Automatic Detection uses a DHCP (Dynamic Host Configuration Protocol) or DNS (Domain Name System) server to detect and configure the Internet Explorer browser settings the first time a user starts the browser.

autoProxyURL

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Auto Configuration Proxy URL")

The file system path to the proxy-configuration script file (.js, .jvs, or .pac) to use for auto-configuration.

defaultDialUpConnection

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Default Dial Up Connection")

The default dial-up connection to use for Internet connections. When connecting to the Internet, the system chooses this connection from a list of possible connections displayed by the Connections tab of the Internet Options dialog box.

deleteExistingConnSettings

Data type: boolean

Access type: Read-only

Qualifiers: DisplayName ("Delete Existing Connection Settings")

If TRUE, the system deletes all existing settings for dial-up connections. If FALSE, the system does not delete the settings.

dialUpConnections

Data type: string array

Access type: Read-only

Qualifiers: DisplayName ("Dial Up Connections")

Array of dial-up connection settings to import.

dialUpState

Data type: uint8

Access type: Read-only

Qualifiers: DisplayName ("Dial Up State")

Indicates when the defaultDialUpConnection setting should be dialed. This property can have one of the following values.

Never dial a connection (0)

Never dial the default setting to make an Internet connection.

Dial whenever a network connection is not present (1)

Dial the default setting when a user starts Internet Explorer and a network connection does not exist.

Always dial my default connection (2)

Always dial the default setting to make an Internet connection.

enableProxy

Data type: boolean

Access type: Read-only

If TRUE, a proxy server is used when connecting to the Internet. If FALSE, a proxy server is not used.

This property is inherited from the RSOP_IEProxySettings class.

ftpProxyServer

Data type: string

Access type: Read-only

Internet address (URL) of the FTP proxy server and the port to use when making an Internet connection in the format RSoP_PROXY:80. The address and port are separated only by a colon and have no intervening space.

This property is inherited from the RSOP_IEProxySettings class.

gopherProxyServer

Data type: string

Access type: Read-only

Internet address of the Gopher proxy server and the port to use when making an Internet connection in the format RSoP_PROXY:80.

This property is inherited from the RSOP_IEProxySettings class.

httpProxyServer

Data type: string

Access type: Read-only

Internet address of the HTTP proxy server and the port to use when making an Internet connection in the format RSoP_PROXY:80.

This property is inherited from the RSOP_IEProxySettings class.

importCurrentConnSettings

Data type: boolean

Access type: Read-only

Qualifiers: DisplayName ("Import Current Connection Settings")

If TRUE, the system imports settings for dial-up connections. If FALSE, connection settings are not customized.

proxyOverride

Data type: string

Access type: Read-only

String that, when specified, identifies Internet addresses for which a proxy server should not be used when making Internet connections. If this property begins with '<local>' it indicates that a proxy server should not be used to connect to Internet addresses on the local area network (LAN).

This property is inherited from the RSOP_IEProxySettings class.

rsopID

Data type: string

Access type: Read-only

Qualifiers: Key

Foreign key to RSOP_PolicySetting.

This property is inherited from the RSOP_IEProxySettings class.

rsopPrecedence

Data type: uint32

Access type: Read-only

Qualifiers: Key

Foreign key to RSOP_PolicySetting.

This property is inherited from the RSOP_IEProxySettings class.

secureProxyServer

Data type: string

Access type: Read-only

Internet address of a secure proxy server and port to use when making an Internet connection in the format RSoP_PROXY:80.

This property is inherited from the RSOP_IEProxySettings class.

socksProxyServer

Data type: string

Access type: Read-only

Internet address of the SOCKS proxy server and port to use when making an Internet connection in the format RSoP_PROXY:80.

This property is inherited from the RSOP_IEProxySettings class.

useSameProxy

Data type: boolean

Access type: Read-only

If TRUE, the same proxy server is used for all network protocols when making an Internet connection. The proxy server used is the server specified by the httpProxyServer property. If FALSE, the system uses the individual settings stored in the httpProxyServer, secureProxyServer, ftpProxyServer, socksProxyServer and gopherProxyServer properties.

This property is inherited from the RSOP_IEProxySettings class.

Remarks

The RSOP_IEConnectionSettings class is derived from the RSOP_IEProxySettings class, which represents the details of a proxy server connection for Internet Explorer. RSOP_IEConnectionSettings inherits all members of the RSOP_IEProxySettings class.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\RSOP\Computer, Root\RSOP\User
MOF
Rsop.mof
DLL
GPSvc.dll

See also

RSOP_IEConnectionSettingsLink

RSOP_IEProxySettings