wlanSetInterface 函数 (wlanapi.h)

项目
08/28/2023

WlanSetInterface 函数为指定接口设置用户可配置的参数。

语法

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

参数

[in] hClientHandle

客户端的会话句柄，由上一次对 WlanOpenHandle 函数的调用获取。

[in] pInterfaceGuid

要配置的接口的 GUID。

[in] OpCode

一个WLAN_INTF_OPCODE值，该值指定要设置的参数。下表列出了 pData 中参数的有效常量和数据类型。

WLAN_INTF_OPCODE 值	pData 数据类型	说明
wlan_intf_opcode_autoconf_enabled	BOOL	启用或禁用指示的接口的自动配置。
wlan_intf_opcode_background_scan_enabled	BOOL	为指示的接口启用或禁用后台扫描。
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	(接口的 PHY) 设置特定物理层的软件无线电状态。
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	设置 BSS 类型。
wlan_intf_opcode_media_streaming_mode	BOOL	设置驱动程序的媒体流模式。
wlan_intf_opcode_current_operation_mode	ULONG	设置接口的当前操作模式。有关详细信息，请参阅“备注”。

具有 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 的无线 LAN API： 只有 wlan_intf_opcode_autoconf_enabled 和 wlan_intf_opcode_bss_type 常量才有效。

[in] dwDataSize

pData 参数的大小（以字节为单位）。如果 dwDataSize 大于分配给 pData 的实际内存量，则调用程序中将发生访问冲突。

[in] pData

要根据 OpCode 参数指定的值进行设置。 pData 指向的数据类型必须适用于指定的 OpCode。使用上表确定要使用的数据类型。

注意如果 OpCode 设置为 wlan_intf_opcode_autoconf_enabled、 wlan_intf_opcode_background_scan_enabled 或 wlan_intf_opcode_media_streaming_mode，则 pData 可能指向整数值。如果 pData 指向 0，则该值将转换为 FALSE。如果 pData 指向非零整数，则该值将转换为 TRUE。

pReserved

保留供将来使用。必须设置为 NULL。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值可能是以下返回代码之一。

注解

当 OpCode 设置为 wlan_intf_opcode_current_operation_mode 时， WlanSetInterface 函数将设置无线接口的当前操作模式。有关操作模式的详细信息，请参阅本机 802.11 操作模式。支持两种操作模式： DOT11_OPERATION_MODE_EXTENSIBLE_STATION 和 DOT11_OPERATION_MODE_NETWORK_MONITOR。操作模式常量在头文件 Windot11.h 中定义。如果在 OpCode 设置为 wlan_intf_opcode_current_operation_mode 时 pData 未指向其中一个值，则 WlanSetInterface 函数将失败并显示错误。

若要在命令行上启用或禁用自动配置服务（在功能上等效于调用 OpCode 设置为 wlan_intf_opcode_autoconf_enabled的 WlanSetInterface），请使用 netsh wlan setautoconfig 命令。有关详细信息，请参阅适用于无线局域网的 Netsh 命令 (wlan) 。

可以通过调用 WlanSetInterface 函数来更改软件无线电状态。无法通过调用 WlanSetInterface 函数更改硬件无线电状态。当 OpCode 参数设置为 wlan_intf_opcode_radio_state 时， WlanSetInterface 函数将设置特定 PHY 的软件无线电状态。 pData 参数必须指向具有要使用的新单选状态值的WLAN_PHY_RADIO_STATE结构。当调用 WlanSetInterface 函数时，将 opCode 参数设置为 wlan_intf_opcode_radio_state 并且 pData 参数指向WLAN_PHY_RADIO_STATE结构时，将忽略 WLAN_PHY_RADIO_STATE 结构的 dot11HardwareRadioState 成员。如果软件无线电状态 (dot11SoftwareRadioState 成员的 WLAN_PHY_RADIO_STATE 结构) 或硬件无线电状态 (dot11HardwareRadioState 成员 WLAN_PHY_RADIO_STATE 结构) 关闭，则 PHY 的无线电状态处于关闭状态。

更改物理网络接口的软件无线电状态可能会导致无线托管网络或虚拟无线适配器无线电状态的相关更改。每个虚拟无线适配器的 PHY 都是链接的。有关详细信息，请参阅关于无线托管网络。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP 和 SP3 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	wlanapi.h (包括 Wlanapi.h)
Library	Wlanapi.lib
DLL	Wlanapi.dll
可再发行组件	适用于 Windows XP 的无线 LAN API SP2

另请参阅

wlanSetInterface 函数 (wlanapi.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

反馈

其他资源