ÉLÉMENT WLANProfile

L’élément WLANProfile contient un profil LAN sans fil. Cet élément est l’élément racine unique d’un profil sans fil.

L’espace de noms cible de l’élément WLANProfile est 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>

Éléments parents

Aucun.

Éléments enfants

nom

Contient le nom d’un profil LAN sans fil.

Un nom respecte la casse.

Pour Windows XP avec Service Pack 3 (SP3) et l’API LAN sans fil pour Windows XP avec Service Pack 2 (SP2), l’élément de nom est ignoré lorsque le profil est enregistré dans le magasin de profils. Le nom du profil est dérivé du SSID du réseau. Pour les profils réseau d’infrastructure, le nom du profil est le SSID du réseau. Pour les profils réseau ad hoc, le nom du profil est le SSID du réseau ad hoc suivi de -adhoc. Les caractères d’échappement XML, tels que &, ne sont pas affichés. Évitez d’utiliser des caractères d’échappement XML dans des noms SSID pour les profils déployés sur Windows XP avec l’API SP3 ou LAN sans fil pour Windows XP avec SP2.

Pour tout profil réseau destiné à être utilisé uniquement sur Windows Vista ou Windows Server 2008, le nom peut être n’importe quelle chaîne.

type de connexion

L’élément connectionType indique le mode d’exploitation du réseau. La valeur ess indique un réseau d’infrastructure, tandis que IBSS indique un réseau ad hoc.

connectionMode

L’élément connectionMode (WLANProfile) indique si la connexion à un réseau local sans fil doit être automatique ou lancée par l’utilisateur.

Si connectionType est défini sur ESS, cette valeur peut être automatique ou manuelle. La valeur par défaut est automatique si cet élément est absent.

Si connectionType est défini sur IBSS, cette valeur doit être manuelle.

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

Le tableau suivant décrit les valeurs d’énumération.

autoSwitch

Détermine le comportement d’itinérance d’un réseau connecté automatiquement lorsqu’un réseau plus préféré est en plage. Cet élément est facultatif.

Si autoSwitch a la valeur « true » et connectionMode est défini sur « auto », une connexion à un réseau plus préféré doit être tentée chaque fois qu’un réseau plus préféré entre dans la plage. Un réseau plus préféré est celui qui est classé plus haut dans la liste des réseaux sans fil préférés. Cette tentative de connexion se produit lorsqu’elle est connectée à un autre réseau.

Si connectionMode est défini sur « auto », cette valeur peut être « true » ou « false ».

Si connectionMode est défini sur « manual », cette valeur doit être définie sur « false ». Cet élément n’a aucun effet sur un réseau connecté manuellement.

Une valeur autoSwitch définie sur « true » entraîne une fréquence plus élevée d’analyse périodique des nouveaux réseaux. Cela peut entraîner une pollution accrue de la fréquence radio à partir de ces analyses périodiques et une consommation d’alimentation accrue utilisée par la carte réseau sans fil.

Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé : Les modifications sont implémentées sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé pour optimiser les performances réseau sans fil. Ces modifications sont conçues pour réduire la pollution de la fréquence radio, la consommation d’énergie et les perturbations du trafic en temps réel sur les réseaux sans fil. Paramètre par défaut pour autoSwitch lorsque cet élément n’est pas défini dans un profil LAN sans fil a changé. Le paramètre par défaut est remplacé par « false » sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé. Le paramètre par défaut était « true » sur Windows Server 2008 et Windows Vista. Il est recommandé que la valeur de l’élément autoSwitch utilisé par une application dans un profil LAN sans fil soit définie sur « false » pour réduire la fréquence d’analyse périodique des nouveaux réseaux, sauf si elle est absolument nécessaire pour qu’une application définisse cette valeur sur « true ».

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Cet élément n’est pas pris en charge.

Remarques

La plupart des éléments enfants de l’élément WLANProfile se trouvent dans l’espace https://www.microsoft.com/networking/WLAN/profile/v1 de noms. Il existe deux exceptions : l’élément FIPSMode se trouve dans l’espace https://www.microsoft.com/networking/WLAN/profile/v2 de noms et l’élément OneX se trouve dans l’espace https://www.microsoft.com/networking/OneX/v1 de noms.

Pour afficher la liste des éléments enfants dans une structure de type arborescence, consultez WLAN_profile Éléments de schéma.

Exemples

Pour afficher des exemples de profils, consultez les exemples de profils sans fil.

Spécifications