Función WlanSetInterface (wlanapi.h)

Artículo
03/13/2024

La función WlanSetInterface establece parámetros configurables por el usuario para una interfaz especificada.

Sintaxis

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

Identificador de sesión del cliente, obtenido por una llamada anterior a la función WlanOpenHandle .

[in] pInterfaceGuid

GUID de la interfaz que se va a configurar.

[in] OpCode

Valor WLAN_INTF_OPCODE que especifica el parámetro que se va a establecer. En la tabla siguiente se enumeran las constantes válidas junto con el tipo de datos del parámetro en pData.

valor de WLAN_INTF_OPCODE	Tipo de datos pData	Descripción
wlan_intf_opcode_autoconf_enabled	BOOL	Habilita o deshabilita la configuración automática para la interfaz indicada.
wlan_intf_opcode_background_scan_enabled	BOOL	Habilita o deshabilita el examen en segundo plano para la interfaz indicada.
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	Establece el estado de radio de software de una capa física específica (PHY) para la interfaz.
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	Establece el tipo BSS.
wlan_intf_opcode_media_streaming_mode	BOOL	Establece el modo de streaming multimedia para el controlador.
wlan_intf_opcode_current_operation_mode	ULONG	Establece el modo de operación actual para la interfaz . Para obtener más información, vea la sección Comentarios.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Solo las constantes wlan_intf_opcode_autoconf_enabled y wlan_intf_opcode_bss_type son válidas.

[in] dwDataSize

Tamaño del parámetro pData , en bytes. Si dwDataSize es mayor que la cantidad real de memoria asignada a pData, se producirá una infracción de acceso en el programa de llamada.

[in] pData

Valor que se va a establecer según lo especificado por el parámetro OpCode . El tipo de datos al que apunta pData debe ser adecuado para el OpCode especificado. Use la tabla anterior para determinar el tipo de datos que se van a usar.

Nota Si OpCode está establecido en wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled o wlan_intf_opcode_media_streaming_mode, pData puede apuntar a un valor entero. Si pData apunta a 0, el valor se convierte en FALSE. Si pData apunta a un entero distinto de cero, el valor se convierte en TRUE.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Comentarios

Cuando OpCode se establece en wlan_intf_opcode_current_operation_mode, la función WlanSetInterface establece el modo de operación actual de la interfaz inalámbrica. Para obtener más información sobre los modos de operación, vea Modos de operación nativos 802.11. Se admiten dos modos de operación: DOT11_OPERATION_MODE_EXTENSIBLE_STATION y DOT11_OPERATION_MODE_NETWORK_MONITOR. Las constantes de modo de operación se definen en el archivo de encabezado Windot11.h. Si pData no apunta a uno de estos valores cuando OpCode está establecido en wlan_intf_opcode_current_operation_mode, se producirá un error en la función WlanSetInterface .

Para habilitar o deshabilitar el servicio de configuración automática en la línea de comandos, que es funcionalmente equivalente a llamar a WlanSetInterface con OpCode establecido en wlan_intf_opcode_autoconf_enabled, use el comando netsh wlan setautoconfig . Para obtener más información, consulte Netsh Commands for Wireless Local Area Network (wlan).

El estado de radio del software se puede cambiar llamando a la función WlanSetInterface . El estado de radio del hardware no se puede cambiar llamando a la función WlanSetInterface . Cuando el parámetro OpCode se establece en wlan_intf_opcode_radio_state, la función WlanSetInterface establece el estado de radio de software de un PHY específico. El parámetro pData debe apuntar a una estructura de WLAN_PHY_RADIO_STATE con los nuevos valores de estado de radio que se van a usar. El miembro dot11HardwareRadioState de la estructura WLAN_PHY_RADIO_STATE se omite cuando se llama a la función WlanSetInterface con el parámetro OpCode establecido en wlan_intf_opcode_radio_state y el parámetro pData apunta a una estructura de WLAN_PHY_RADIO_STATE . El estado de radio de un PHY está desactivado si el estado de radio de software (dot11SoftwareRadioState miembro de la estructura WLAN_PHY_RADIO_STATE ) o el estado de radio de hardware (dot11HardwareRadioState miembro de la estructura WLAN_PHY_RADIO_STATE ) está desactivado.

Cambiar el estado de radio de software de una interfaz de red física podría provocar cambios relacionados en el estado de la red inalámbrica hospedada o los estados de radio del adaptador inalámbrico virtual. Los PHY de cada adaptador inalámbrico virtual están vinculados. Para obtener más información, consulta acerca de la red inalámbrica hospedada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wlanapi.h (incluya Wlanapi.h)
Library	Wlanapi.lib
Archivo DLL	Wlanapi.dll
Redistribuible	API de LAN inalámbrica para Windows XP con SP2