wlanSetInterface 函数 (wlanapi.h)
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。 使用上表确定要使用的数据类型。
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 |