WlanSetInterface 函式 (wlanapi.h)

發行項
03/13/2024

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。使用上表來判斷要使用的數據類型。

注意如果 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 中。如果 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