共用方式為

WlanSetProfileList 函式 (wlanapi.h)

  • 發行項

WlanSetProfileList 函式會設定指定介面配置檔的喜好設定順序。

語法

DWORD WlanSetProfileList(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] DWORD      dwItems,
  [in] LPCWSTR    *strProfileNames,
       PVOID      pReserved
);

參數

[in] hClientHandle

用戶端的會話句柄，由先前呼叫 WlanOpenHandle 函式取得。

[in] pInterfaceGuid

介面的 GUID。

[in] dwItems

strProfileNames 參數中的配置檔數目。

[in] strProfileNames

所需順序的配置檔名稱。 配置檔名稱會區分大小寫。 此字串必須以 NULL 結束。

Windows XP 搭配 SP3 和適用於 Windows XP 的無線 LAN API 與 SP2： 提供的名稱必須符合從網路的 SSID 自動衍生的設定檔名稱。 針對基礎結構網路配置檔，必須針對配置檔名稱提供 SSID。 針對臨機操作網路配置檔，提供的名稱必須是臨機操作網路的 SSID， -adhoc後面接著 。

pReserved

保留供未來使用。 必須設定為 NULL。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼 Description
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權可變更配置檔清單。

在 WlanSetProfileList 執行作業時，會變更配置檔清單中所有使用者配置檔的相對順序，或將所有使用者配置檔移至配置檔清單中的較低位置，WlanSetProfileList 會擷取任意訪問控制清單， (DACL) 與wlan_secure_all_user_profiles_order物件一起儲存。 如果 DACL 不包含存取控制專案 (ACE) 授與呼叫線程存取令牌WLAN_WRITE_ACCESS許可權， 則 WlanSetProfileList 會傳回 ERROR_ACCESS_DENIED。
ERROR_INVALID_HANDLE
 句柄數據表中找不到句柄 hClientHandle 。
ERROR_INVALID_PARAMETER
 發生下列其中一個條件：
  • hClientHandle 為 NULL 或無效。
  • pInterfaceGuid 為 NULL。
  • dwItems 為 0。
  • strProfileNames 為 NULL。
  • strProfileNames 中會出現多次相同的配置檔名稱。
  • pReserved 不是 NULL。
ERROR_NOT_FOUND
 strProfileNames 包含配置檔存放區中不存在的配置檔名稱。
RPC_STATUS
 各種錯誤碼。

備註

WlanSetProfileList 函式會設定指定無線介面無線 LAN 配置檔的喜好設定順序。

清單中的配置檔必須與 WlanGetProfileList 函式傳回的目前配置檔一對一相符。 組策略配置檔的位置無法變更。

執行設定文件作業時，所有無線 LAN 函式都需要無線介面的介面 GUID。 拿掉無線介面時，其狀態會從無線 LAN 服務 (WLANSVC) 清除，而且無法執行任何配置檔作業。

如果 pInterfaceGuid 參數中指定的無線介面已從系統移除 (已移除的 USB 無線適配卡，WlanSetProfileList 函式可能會失敗 ERROR_INVALID_PARAMETER，例如) 。

規格需求

需求 值
最低支援的用戶端 Windows Vista、Windows XP 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll
可轉散發套件 適用於 Windows XP 與 SP2 的無線 LAN API

另請參閱

WlanGetProfile

WlanGetProfileList

WlanSetProfile