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 數據類型 | Description |
|---|---|---|
| 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 | 設定介面的目前作業模式。 如需詳細資訊，請參閱＜備註＞。 |
Windows XP with SP3 和 Wireless LAN API for Windows XP with SP2： 只有 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 中。 如果 pData 未在 OpCode 設定為 wlan_intf_opcode_current_operation_mode 時指向其中一個值， WlanSetInterface 函式將會失敗並出現錯誤。
若要在命令行啟用或停用自動設定服務，其功能相當於呼叫 WlanSetInterface 並將 OpCode 設定為 wlan_intf_opcode_autoconf_enabled，請使用 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 成員。 如果軟體無線電狀態 (dot11SoftwareRadioStateWLAN_PHY_RADIO_STATE 結構的成員) 或 (dot11HardwareRadioState 成員的硬體無線電狀態 (dot11HardwareRadioState 成員已關閉) ，則為 WLAN_PHY_RADIO_STATE PHY 的無線電狀態。
變更實體網路介面的軟體無線電狀態可能會導致無線裝載網路或虛擬無線適配卡無線電狀態的狀態相關變更。 每個虛擬無線適配卡的 PHY 都會連結。 如需詳細資訊，請參閱 關於無線託管網路。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista、Windows XP SP3 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | wlanapi.h (包含 Wlanapi.h) |
| 程式庫 | Wlanapi.lib |
| Dll | Wlanapi.dll |
| 可轉散發套件 | Windows XP 搭配 SP2 的無線 LAN API |