WLANProfile 要素

WLANProfile 要素には、ワイヤレス LAN プロファイルが含まれています。 この要素は、ワイヤレス プロファイルの一意のルート要素です。

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>

親要素

なし。

子要素

名前

ワイヤレス LAN プロファイルの名前を格納します。

名前では大文字と小文字が区別されます。

Service Pack 3 (SP3) の Windows XP および Windows XP Service Pack 2 (SP2) 用ワイヤレス LAN API の場合、プロファイルがプロファイル ストアに保存されている場合、 name 要素は無視されます。 プロファイルの名前は、ネットワークの SSID から派生します。 インフラストラクチャ ネットワーク プロファイルの場合、プロファイルの名前はネットワークの SSID です。 アドホック ネットワーク プロファイルの場合、プロファイルの名前はアドホック ネットワークの SSID の後に -adhoc。 XML エスケープ文字 (> など) は表示されません。 SP3 を使用して Windows XP に展開されたプロファイルの SSID 名には XML エスケープ文字を使用しないでください。SP2 では Windows XP 用ワイヤレス LAN API を使用しないでください。

Windows Vista または Windows Server 2008 でのみ使用するネットワーク プロファイルの場合、名前は任意の文字列にすることができます。

接続タイプ

connectionType 要素は、ネットワークの動作モードを示します。 値 ESS はインフラストラクチャ ネットワークを示し、IBSS はアドホック ネットワークを示します。

connectionMode

connectionMode (WLANProfile) 要素は、ワイヤレス LAN への接続を自動にするか、ユーザーが開始するかを示します。

connectionType が ESS に設定されている場合、この値は auto または manual のいずれかになります。 この要素が存在しない場合、既定値は auto です。

connectionType が IBSS に設定されている場合、この値は手動である必要があります。

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

次の表では、列挙値について説明します。

autoSwitch

優先ネットワークが範囲内にある場合の自動接続ネットワークのローミング動作を決定します。 この要素は省略可能です。

autoSwitch が "true" で connectionMode が "auto" に設定されている場合は、より優先されるネットワークが範囲に入るたびに、より優先されるネットワークへの接続を試行する必要があります。 より優先されるネットワークは、優先ワイヤレス ネットワークの一覧の上位に並べ替えられたネットワークです。 この接続試行は、別のネットワークに接続したときに発生します。

connectionMode が "auto" に設定されている場合、この値は "true" または "false" のいずれかになります。

connectionMode が "manual" に設定されている場合、この値は "false" に設定する必要があります。 この要素は、手動で接続されたネットワークには影響しません。

autoSwitch 値を "true" に設定すると、新しいネットワークの定期的なスキャンの頻度が高くなります。 これにより、これらの定期的なスキャンによる無線周波数の汚染が増加し、ワイヤレス ネットワーク アダプターで使用される電力消費量が増加する可能性があります。

Windows 7 および Windows Server 2008 R2 とワイヤレス LAN サービスがインストールされています。 変更は、ワイヤレス ネットワークのパフォーマンスを最適化するために、ワイヤレス LAN サービスがインストールされた Windows 7 および Windows Server 2008 R2 に実装されます。 これらの変更は、無線ネットワーク上のリアルタイム トラフィックに対する無線周波数の汚染、電力消費量、および中断を軽減するように設計されています。 ワイヤレス LAN プロファイルでこの要素が設定されていない場合の autoSwitch の既定の設定が変更されました。 ワイヤレス LAN サービスがインストールされている Windows 7 および Windows Server 2008 R2 では、既定の設定が "false" に変更されます。 Windows Server 2008 および Windows Vista では、既定の設定は "true" でした。 アプリケーションでこの値を "true" に設定する必要がない限り、新しいネットワークの定期的なスキャンの頻度を減らすために、ワイヤレス LAN プロファイルのアプリケーションで使用される autoSwitch 要素の値を "false" に設定することをお勧めします。

Windows XP SP3 とワイヤレス LAN API for Windows XP SP2: この要素はサポートされていません。

注釈

WLANProfile 要素のほとんどの子要素は、 https://www.microsoft.com/networking/WLAN/profile/v1 名前空間にあります。 FIPSMode 要素が https://www.microsoft.com/networking/WLAN/profile/v2 名前空間にあり、OneX 要素が https://www.microsoft.com/networking/OneX/v1 名前空間にあるという 2 つの例外があります。

ツリーに似た構造の子要素の一覧を表示するには、「 スキーマ要素のWLAN_profile」を参照してください。

例示

サンプル プロファイルを表示するには、 ワイヤレス プロファイルのサンプルを参照してください。

要求事項