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.
| 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.
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 |