Elemento WLANProfile

Articolo
01/10/2024

L'elemento WLANProfile contiene un profilo LAN wireless. Questo elemento è l'elemento radice univoco per un profilo wireless.

Lo spazio dei nomi di destinazione per l'elemento WLANProfile è 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>

Elementi padre

Nessuno.

Elementi figlio

Elemento	Tipo	Descrizione
name	nameType	Nome del profilo WLAN.
SSIDConfig		Contiene uno o più SSID per reti LAN wireless.
Hotspot2		Estende lo schema del profilo WLAN v1 per supportare le reti Hotspot 2.0.
Connectiontype		Indica se la rete è un'infrastruttura ("ESS") o ad hoc ("IBSS").
connectionMode		Indica se la connessione alla LAN wireless deve essere automatica ("auto") o avviata ("manuale") dall'utente. Questo elemento è facoltativo.
autoSwitch	boolean	Determina il comportamento di roaming di una rete connessa automaticamente quando una rete preferita è nell'intervallo. Questo elemento è facoltativo e non ha alcun effetto su una rete connessa manualmente.
MSM		Contiene varie impostazioni del modulo specifico del supporto (MSM).
IHV		Contiene varie impostazioni per i fornitori di hardware indipendenti.
MacRandomization		Configura la casualità degli indirizzi MAC.

name

Contiene il nome di un profilo LAN wireless.

Un nome fa distinzione tra maiuscole e minuscole.

Per Windows XP con Service Pack 3 (SP3) e l'API LAN wireless per Windows XP con Service Pack 2 (SP2), l'elemento name viene ignorato quando il profilo viene salvato nell'archivio profili. Il nome del profilo deriva dall'SSID della rete. Per i profili di rete dell'infrastruttura, il nome del profilo è il SSID della rete. Per i profili di rete ad hoc, il nome del profilo è il SSID della rete ad hoc seguita da -adhoc. I caratteri di escape XML, ad esempio &, non vengono visualizzati. Evitare di usare caratteri di escape XML nei nomi SSID per i profili distribuiti in Windows XP con SP3 o l'API LAN wireless per Windows XP con SP2.

Per qualsiasi profilo di rete destinato all'uso solo in Windows Vista o Windows Server 2008, il nome può essere qualsiasi stringa.

connectionType

L'elemento connectionType indica la modalità operativa della rete. Un valore di ESS indica una rete dell'infrastruttura, mentre IBSS indica una rete ad hoc.

connectionMode

L'elemento connectionMode (WLANProfile) indica se la connessione a una LAN wireless deve essere automatica o avviata dall'utente.

Se connectionType è impostato su ESS, questo valore può essere automatico o manuale. Il valore predefinito è automatico se questo elemento è assente.

Se connectionType è impostato su IBSS, questo valore deve essere manuale.

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

Nella tabella seguente vengono descritti i valori di enumerazione.

Valore	Descrizione
auto	La connessione alla rete wireless deve essere avviata automaticamente ogni volta che la rete è in intervallo.
manual	La connessione alla rete wireless viene inita solo alla richiesta esplicita di un utente.

autoSwitch

Determina il comportamento di roaming di una rete connessa automaticamente quando una rete preferita è nell'intervallo. Questo elemento è facoltativo.

Se autoSwitch è "true" e connectionMode è impostato su "auto", deve essere tentata una connessione a una rete più preferita ogni volta che si trova un intervallo di rete più preferito. Una rete più preferita è quella ordinata più in alto nell'elenco delle reti wireless preferite. Questo tentativo di connessione si verifica quando si è connessi a un'altra rete.

Se connectionMode è impostato su "auto", questo valore può essere "true" o "false".

Se connectionMode è impostato su "manual", questo valore deve essere impostato su "false". Questo elemento non ha alcun effetto su una rete connessa manualmente.

Un valore autoSwitch impostato su "true" comporta una maggiore frequenza di analisi periodica per le nuove reti. Ciò può comportare un aumento dell'inquinamento della frequenza radio da queste analisi periodiche e un maggiore consumo di energia utilizzato dalla scheda di rete wireless.

Windows 7 e Windows Server 2008 R2 con il servizio LAN wireless installato: le modifiche vengono implementate in Windows 7 e Windows Server 2008 R2 con il servizio LAN wireless installato per ottimizzare le prestazioni di rete wireless. Queste modifiche sono progettate per ridurre l'inquinamento della frequenza radio, il consumo di energia e le interruzioni del traffico in tempo reale sulle reti wireless. L'impostazione predefinita per autoSwitch quando questo elemento non è impostato in un profilo LAN wireless è stato modificato. L'impostazione predefinita viene modificata in "false" in Windows 7 e Windows Server 2008 R2 con il servizio LAN wireless installato. L'impostazione predefinita è "true" in Windows Server 2008 e Windows Vista. È consigliabile impostare il valore dell'elemento autoSwitch utilizzato da un'applicazione in un profilo LAN wireless su "false" per ridurre la frequenza di analisi periodica per le nuove reti, a meno che non sia assolutamente necessario per un'applicazione impostare questo valore su "true".

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: questo elemento non è supportato.

Osservazioni:

La maggior parte degli elementi figlio dell'elemento WLANProfile si trova nello spazio dei https://www.microsoft.com/networking/WLAN/profile/v1 nomi . Esistono due eccezioni: l'elemento FIPSMode si trova nello https://www.microsoft.com/networking/WLAN/profile/v2 spazio dei nomi e l'elemento OneX si trova nello spazio dei https://www.microsoft.com/networking/OneX/v1 nomi .

Per visualizzare l'elenco di elementi figlio in una struttura simile ad albero, vedere WLAN_profile Elementi dello schema.

Esempi

Per visualizzare i profili di esempio, vedere Esempi di profili wireless.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Componente ridistribuibile	API LAN wireless per Windows XP con SP2