Elemento WLANProfile

  • Artigo

O elemento WLANProfile contém um perfil lan sem fio. Esse elemento é o elemento raiz exclusivo para um perfil sem fio.

O namespace de destino para o 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>

Elementos pai

Nenhum.

Elementos filho

Elemento Type Descrição
name nameType Nome do perfil WLAN.
SSIDConfig Contém um ou mais SSIDs para LANs sem fio.
Hotspot2 Estende o esquema de perfil WLAN v1 para dar suporte a redes Hotspot 2.0.
connectionType Indica se a rede é de infraestrutura ("ESS") ou ad hoc ("IBSS").
connectionMode Indica se a conexão com a LAN sem fio deve ser automática ("automática") ou iniciada ("manual") pelo usuário. Esse elemento é opcional.
Autoswitch booleano Determina o comportamento de roaming de uma rede conectada automaticamente quando uma rede mais preferencial está no intervalo. Esse elemento é opcional e não tem efeito em uma rede conectada manualmente.
MSM Contém várias configurações de MSM (módulo específico de mídia).
IHV Contém várias configurações para fornecedores independentes de hardware.
MacRandomization Configura a randomização de endereços MAC.

name

Contém o nome de um perfil lan sem fio.

Um nome diferencia maiúsculas de minúsculas.

Para Windows XP com Service Pack 3 (SP3) e API lan sem fio para Windows XP com Service Pack 2 (SP2), o elemento name é ignorado quando o perfil é salvo no repositório de perfis. O nome do perfil é derivado do SSID da rede. Para perfis de rede de infraestrutura, o nome do perfil é o SSID da rede. Para perfis de rede ad hoc, o nome do perfil é o SSID da rede ad hoc seguido por -adhoc. Caracteres de escape XML, como &, não são exibidos. Evite usar caracteres de escape XML em nomes SSID para perfis implantados no Windows XP com SP3 ou API lan sem fio para Windows XP com SP2.

Para qualquer perfil de rede destinado a uso somente no Windows Vista ou no Windows Server 2008, o nome pode ser qualquer cadeia de caracteres.

connectionType

O elemento connectionType indica o modo de operação da rede. Um valor de ESS indica uma rede de infraestrutura, enquanto o IBSS indica uma rede ad hoc.

connectionMode

O elemento connectionMode (WLANProfile) indica se a conexão com uma LAN sem fio deve ser automática ou iniciada pelo usuário.

Se connectionType estiver definido como ESS, esse valor poderá ser automático ou manual. O valor padrão será automático se esse elemento estiver ausente.

Se connectionType for definido como IBSS, esse valor deverá 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>

A tabela a seguir descreve os valores de enumeração.

Valor Descrição
auto A conexão com a rede sem fio deve ser iniciada automaticamente sempre que a rede estiver no intervalo.
manual A conexão com a rede sem fio só é initada mediante a solicitação explícita de um usuário.

Autoswitch

Determina o comportamento de roaming de uma rede conectada automaticamente quando uma rede mais preferencial está no intervalo. Esse elemento é opcional.

Se autoSwitch for "true" e connectionMode for definido como "auto", uma conexão com uma rede mais preferencial deverá ser tentada sempre que uma rede mais preferencial entrar no intervalo. Uma rede mais preferencial é aquela que é ordenada mais alto na lista de redes sem fio preferenciais. Essa tentativa de conexão ocorre quando conectada a outra rede.

Se connectionMode for definido como "auto", esse valor poderá ser "true" ou "false".

Se connectionMode for definido como "manual", esse valor deverá ser definido como "false". Esse elemento não tem efeito em uma rede conectada manualmente.

Um valor autoSwitch definido como "true" resulta em uma frequência mais alta de verificação periódica para novas redes. Isso pode resultar no aumento da poluição por radiofrequência dessas verificações periódicas e no aumento do consumo de energia usado pelo adaptador de rede sem fio.

Windows 7 e Windows Server 2008 R2 com o Serviço lan sem fio instalado: As alterações são implementadas no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado para otimizar o desempenho da rede sem fio. Essas alterações foram projetadas para reduzir a poluição por radiofrequência, o consumo de energia e a interrupção do tráfego em tempo real por redes sem fio. A configuração padrão para autoSwitch quando esse elemento não está definido em um perfil lan sem fio foi alterada. A configuração padrão é alterada para "false" no Windows 7 e no Windows Server 2008 R2 com o Serviço lan sem fio instalado. A configuração padrão era "true" no Windows Server 2008 e no Windows Vista. É recomendável que o valor do elemento autoSwitch usado por um aplicativo em um perfil lan sem fio seja definido como "false" para reduzir a frequência de verificação periódica para novas redes, a menos que seja absolutamente necessário que um aplicativo defina esse valor como "true".

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Não há suporte para esse elemento.

Comentários

A maioria dos elementos filho do elemento WLANProfile está no https://www.microsoft.com/networking/WLAN/profile/v1 namespace . Há duas exceções: o elemento FIPSMode está no https://www.microsoft.com/networking/WLAN/profile/v2 namespace e o elemento OneX está no https://www.microsoft.com/networking/OneX/v1 namespace .

Para exibir a lista de elementos filho em uma estrutura semelhante a uma árvore, consulte WLAN_profile Elementos de esquema.

Exemplos

Para exibir perfis de exemplo, consulte Exemplos de perfil sem fio.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Redistribuível API de LAN sem fio para Windows XP com SP2