Função WlanSetInterface (wlanapi.h)

Artigo
08/28/2023

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.

WLAN_INTF_OPCODE valor	Tipo de dados pData	Descrição
wlan_intf_opcode_autoconf_enabled	BOOL	Habilita ou desabilita a configuração automática para a interface indicada.
wlan_intf_opcode_background_scan_enabled	BOOL	Habilita ou desabilita a verificação em segundo plano para a interface indicada.
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	Define o estado de rádio de software de uma PHY (camada física) específica para a interface.
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	Define o tipo BSS.
wlan_intf_opcode_media_streaming_mode	BOOL	Define o modo de streaming de mídia para o driver.
wlan_intf_opcode_current_operation_mode	ULONG	Define o modo de operação atual para a interface. Para obter mais informações, consulte Comentários.

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.

Nota Se OpCode for definido como wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled ou wlan_intf_opcode_media_streaming_mode, pData poderá apontar para um valor inteiro. Se pData apontar para 0, o valor será convertido em FALSE. Se pData apontar para um inteiro diferente de zero, o valor será convertido em TRUE.

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

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]
Plataforma de Destino	Windows
Cabeçalho	wlanapi.h (inclua Wlanapi.h)
Biblioteca	Wlanapi.lib
DLL	Wlanapi.dll
Redistribuível	API de LAN sem fio para Windows XP com SP2