Windows Dev Center

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.

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

Namespace

Root\RSOP\Computer, Root\RSOP\User

MOF

Rsop.mof

DLL

GPSvc.dll

See also

RSOP_IEConnectionSettingsLink
RSOP_IEProxySettings

 

 

Show:
© 2015 Microsoft