autoSwitch (WLANProfile) Element
The autoSwitch (WLANProfile) element determines the roaming behavior of an auto-connected network when a more preferred network is in range. . This element is optional.
If autoSwitch is "true" and connectionMode is set to "auto", a connection to a more preferred network must be attempted whenever a more preferred network comes into range. A more preferred network is one that is ordered higher in the list of preferred wireless networks. This connection attempt occurs when connected to another network.
If connectionMode is set to "auto", this value can be either "true" or "false".
If connectionMode is set to "manual", this value must be set to "false". This element has no effect on a manually connected network.
An autoSwitch value set to "true" results in a higher frequency of periodic scanning for new networks. This may result in increased radio frequency pollution from these periodic scans and increased power consumption used by the wireless network adapter.
Windows 7 and Windows Server 2008 R2 with the Wireless LAN Service installed: Changes are implemented on Windows 7 and Windows Server 2008 R2 with the Wireless LAN Service installed to optimize wireless networking performance. These changes are designed to reduce radio frequency pollution, power consumption, and disruption to real-time traffic over wireless networks. The default setting for autoSwitch when this element is not set in a wireless LAN profile has changed. The default setting is changed to "false" on Windows 7 and Windows Server 2008 R2 with the Wireless LAN Service installed. The default setting was "true" on Windows Server 2008 and Windows Vista. It is recommended that the value of the autoSwitch element used by an application in a wireless LAN profile be set to "false" to reduce the frequency of periodic scanning for new networks, unless it is absolutely necessary for an application to set this value to "true".
Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: This element is not supported.
<xs:element name="autoSwitch" type="boolean" />
The autoSwitch element is defined by the WLANProfile element.
To view sample profiles that use the autoSwitch element, see Wireless Profile Samples.
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
- Definition context of element in schema
- Possible immediate parent element in schema instance