Función WlanSetInterface (wlanapi.h)
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.
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 |