Função WlanSetInterface (wlanapi.h)

A função WlanSetInterface define parâmetros configuráveis pelo usuário para uma interface especificada.

Sintaxe

DWORD WlanSetInterface(
  [in] HANDLE           hClientHandle,
  [in] const GUID       *pInterfaceGuid,
  [in] WLAN_INTF_OPCODE OpCode,
  [in] DWORD            dwDataSize,
  [in] const PVOID      pData,
       PVOID            pReserved
);

Parâmetros

[in] hClientHandle

O identificador de sessão do cliente, obtido por uma chamada anterior para a função WlanOpenHandle .

[in] pInterfaceGuid

O GUID da interface a ser configurada.

[in] OpCode

Um valor WLAN_INTF_OPCODE que especifica o parâmetro a ser definido. A tabela a seguir lista as constantes válidas junto com o tipo de dados do parâmetro em pData.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Somente as constantes wlan_intf_opcode_autoconf_enabled e wlan_intf_opcode_bss_type são válidas.

[in] dwDataSize

O tamanho do parâmetro pData , em bytes. Se dwDataSize for maior que a quantidade real de memória alocada para pData, uma violação de acesso ocorrerá no programa de chamada.

[in] pData

O valor a ser definido conforme especificado pelo parâmetro OpCode . O tipo de dados apontado por pData deve ser apropriado para o OpCode especificado. Use a tabela acima para determinar o tipo de dados a serem usados.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Comentários

Quando OpCode é definido como wlan_intf_opcode_current_operation_mode, a função WlanSetInterface define o modo de operação atual da interface sem fio. Para obter mais informações sobre modos de operação, consulte Modos de operação nativos 802.11. Há suporte para dois modos de operação: DOT11_OPERATION_MODE_EXTENSIBLE_STATION e DOT11_OPERATION_MODE_NETWORK_MONITOR. As constantes do modo de operação são definidas no arquivo de cabeçalho Windot11.h. Se pData não apontar para um desses valores quando OpCode for definido como wlan_intf_opcode_current_operation_mode, a função WlanSetInterface falhará com um erro.

Para habilitar ou desabilitar o serviço de configuração automática na linha de comando, que é funcionalmente equivalente a chamar WlanSetInterface com OpCode definido como wlan_intf_opcode_autoconf_enabled, use o comando netsh wlan setautoconfig . Para obter mais informações, consulte Comandos netsh para rede local sem fio (wlan).

O estado de rádio de software pode ser alterado chamando a função WlanSetInterface . O estado de rádio de hardware não pode ser alterado chamando a função WlanSetInterface . Quando o parâmetro OpCode é definido como wlan_intf_opcode_radio_state, a função WlanSetInterface define o estado de rádio de software de um PHY específico. O parâmetro pData deve apontar para uma estrutura de WLAN_PHY_RADIO_STATE com os novos valores de estado de rádio a serem usados. O membro dot11HardwareRadioState da estrutura WLAN_PHY_RADIO_STATE é ignorado quando a função WlanSetInterface é chamada com o parâmetro OpCode definido como wlan_intf_opcode_radio_state e o parâmetro pData aponta para uma estrutura WLAN_PHY_RADIO_STATE . O estado de rádio de um PHY estará desativado se o estado de rádio de software (dot11SoftwareRadioState membro da estrutura WLAN_PHY_RADIO_STATE ) ou o estado de rádio de hardware (membro dot11HardwareRadioState da estrutura WLAN_PHY_RADIO_STATE ) estiver desativado.

Alterar o estado de rádio de software de um adaptador de rede física pode causar alterações relacionadas no estado dos estados de rádio rede hospedada sem fio ou adaptador sem fio virtual. Os PHYs de cada adaptador sem fio virtual estão vinculados. Para obter mais informações, consulte Sobre a rede hospedada sem fio.

Requisitos

Confira também

Sobre a rede hospedada sem fio

DOT11_BSS_TYPE

WLAN_INTF_OPCODE

WLAN_PHY_RADIO_STATE

WlanQueryInterface