Elemento WLANProfile

Artículo
06/26/2023

El elemento WLANProfile contiene un perfil LAN inalámbrico. Este elemento es el elemento raíz único para un perfil inalámbrico.

El espacio de nombres de destino del elemento WLANProfile es https://www.microsoft.com/networking/WLAN/profile/v1.

<xs:element name="WLANProfile">
    <xs:complexType>
        <xs:sequence>
            <xs:element name="name"
                type="nameType"
             />
            <xs:element name="SSIDConfig"
                maxOccurs="256"
                ...
             />
            <xs:element name="Hotspot2"
                minOccurs="0"
                ...
             />
            <xs:element name="connectionType">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="IBSS">
                        <xs:enumeration value="ESS">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="connectionMode"
                minOccurs="0"
             >
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="auto">
                        <xs:enumeration value="manual">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="autoSwitch"
                minOccurs="0"
                type="boolean"
             />
            <xs:element name="MSM"
                minOccurs="0"
                ...
             />
            <xs:element name="IHV"
                minOccurs="0"
                ...
             />
            <xs:element name="MacRandomization"
                ...
             />
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

Elementos primarios

Ninguno.

Elementos secundarios

Elemento	Tipo	Descripción
name	nameType	Nombre del perfil WLAN.
SSIDConfig		Contiene uno o varios SSID para redes LAN inalámbricas.
Hotspot2		Extiende el esquema de perfil WLAN v1 para admitir redes Hotspot 2.0.
connectionType		Indica si la red es infraestructura ("ESS") o ad hoc ("IBSS").
connectionMode		Indica si la conexión a la LAN inalámbrica debe ser automática ("auto") o iniciada ("manual") por el usuario. Este elemento es opcional.
autoSwitch	boolean	Determina el comportamiento de itinerancia de una red conectada automáticamente cuando una red más preferida está en el intervalo. Este elemento es opcional y no tiene ningún efecto en una red conectada manualmente.
MSM		Contiene varias configuraciones de módulos específicos de medios (MSM).
IHV		Contiene varias opciones de configuración para proveedores de hardware independientes.
MacRandomization		Configura la selección aleatoria de direcciones MAC.

name

Contiene el nombre de un perfil LAN inalámbrico.

Un nombre distingue mayúsculas de minúsculas.

Para Windows XP con Service Pack 3 (SP3) y LAN inalámbrica API para Windows XP con Service Pack 2 (SP2), el elemento name se omite cuando el perfil se guarda en el almacén de perfiles. El nombre del perfil se deriva del SSID de la red. En el caso de los perfiles de red de infraestructura, el nombre del perfil es el SSID de la red. En el caso de los perfiles de red ad hoc, el nombre del perfil es el SSID de la red ad hoc seguida de -adhoc. No se muestran caracteres de escape XML, como &, . Evite usar caracteres de escape XML en nombres SSID para perfiles implementados en Windows XP con SP3 o LAN inalámbrica API para Windows XP con SP2.

Para cualquier perfil de red diseñado para su uso solo en Windows Vista o Windows Server 2008, el nombre puede ser cualquier cadena.

connectionType

El elemento connectionType indica el modo de funcionamiento de la red. Un valor de ESS indica una red de infraestructura, mientras que IBSS indica una red ad hoc.

connectionMode

El elemento connectionMode (WLANProfile) indica si la conexión a una LAN inalámbrica debe ser automática o iniciada por el usuario.

Si connectionType se establece en ESS, este valor puede ser automático o manual. El valor predeterminado es automático si este elemento está ausente.

Si connectionType se establece en IBSS, este valor debe ser manual.

<xs:element name="connectionMode">
    <xs:simpleType>
        <xs:restriction
            base="string"
        >
            <xs:enumeration
                value="auto"
             />
            <xs:enumeration
                value="manual"
             />
        </xs:restriction>
    </xs:simpleType>
</xs:element>

En la tabla siguiente se describen los valores de enumeración.

Value	Descripción
auto	La conexión a la red inalámbrica se debe iniciar automáticamente cada vez que la red está en el alcance.
manual	La conexión a la red inalámbrica solo se initata tras la solicitud explícita de un usuario.

autoSwitch

Determina el comportamiento de itinerancia de una red conectada automáticamente cuando una red más preferida está en el intervalo. Este elemento es opcional.

Si autoSwitch es "true" y connectionMode se establece en "auto", se debe intentar una conexión a una red más preferida cada vez que una red más preferida entra en el intervalo. Una red más preferida es una que se ordena más arriba en la lista de redes inalámbricas preferidas. Este intento de conexión se produce cuando se conecta a otra red.

Si connectionMode está establecido en "auto", este valor puede ser "true" o "false".

Si connectionMode está establecido en "manual", este valor debe establecerse en "false". Este elemento no tiene ningún efecto en una red conectada manualmente.

Un valor de autoSwitch establecido en "true" da como resultado una mayor frecuencia de examen periódico de nuevas redes. Esto puede dar lugar a un aumento de la contaminación por frecuencia de radio a partir de estos exámenes periódicos y un mayor consumo de energía utilizado por el adaptador de red inalámbrica.

Windows 7 y Windows Server 2008 R2 con el servicio LAN inalámbrico instalado: Los cambios se implementan en Windows 7 y Windows Server 2008 R2 con el servicio LAN inalámbrico instalado para optimizar el rendimiento de las redes inalámbricas. Estos cambios están diseñados para reducir la contaminación de la frecuencia de radio, el consumo de energía y la interrupción del tráfico en tiempo real a través de redes inalámbricas. La configuración predeterminada para autoSwitch cuando este elemento no está establecido en un perfil de LAN inalámbrico ha cambiado. La configuración predeterminada se cambia a "false" en Windows 7 y Windows Server 2008 R2 con el servicio LAN inalámbrico instalado. La configuración predeterminada era "true" en Windows Server 2008 y Windows Vista. Se recomienda que el valor del elemento autoSwitch usado por una aplicación en un perfil de LAN inalámbrico se establezca en "false" para reducir la frecuencia del examen periódico de nuevas redes, a menos que sea absolutamente necesario que una aplicación establezca este valor en "true".

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Este elemento no se admite.

Observaciones

La mayoría de los elementos secundarios del elemento WLANProfile están en el https://www.microsoft.com/networking/WLAN/profile/v1 espacio de nombres . Hay dos excepciones: el elemento FIPSMode está en el https://www.microsoft.com/networking/WLAN/profile/v2 espacio de nombres y el elemento OneX está en el https://www.microsoft.com/networking/OneX/v1 espacio de nombres.

Para ver la lista de elementos secundarios en una estructura similar a un árbol, vea WLAN_profile elementos de esquema.

Ejemplos

Para ver perfiles de ejemplo, consulte Ejemplos de perfiles inalámbricos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Redistribuible	API LAN inalámbrica para Windows XP con SP2

Compartir a través de