共用方式為

WlanSetProfilePosition 函式 (wlanapi.h)

  • 發行項

WlanSetProfilePosition 函式會在喜好設定清單中設定單一指定配置檔的位置。

語法

DWORD WlanSetProfilePosition(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strProfileName,
  [in] DWORD      dwPosition,
       PVOID      pReserved
);

參數

[in] hClientHandle

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

[in] pInterfaceGuid

介面的 GUID。

[in] strProfileName

設定檔的名稱。 配置檔名稱會區分大小寫。 此字串必須以 NULL 終止。

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

[in] dwPosition

指出喜好設定清單中應該將配置檔移位的位置。 0 (零) 會對應至 WlanGetProfileList 函式所傳回之清單中的第一個配置檔。

pReserved

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

傳回值

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

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

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

在 WlanSetProfilePosition 執行作業，該作業會變更設定檔清單中的所有使用者配置檔的相對順序，或將所有使用者配置檔移至設定檔清單中的較低位置，WlanSetProfilePosition 會 (擷取與wlan_secure_all_user_profiles_order物件一起儲存的 DACL) 任意存取控制清單。 如果 DACL 不包含存取控制專案 (ACE) 授與呼叫線程之存取令牌的WLAN_WRITE_ACCESS許可權， 則 WlanSetProfilePosition 會 傳回ERROR_ACCESS_DENIED。
ERROR_INVALID_PARAMETER
 hClientHandle 為 NULL 或無效， pInterfaceGuid 為 NULL、 strProfileName 為 NULL，或 pReserved 不是 NULL。
ERROR_INVALID_HANDLE
 句柄數據表中找不到句柄 hClientHandle 。
RPC_STATUS
 各種錯誤碼。

備註

無法變更組策略配置檔的位置。

根據預設，只有以 Administrators 群組成員身分登入的使用者可以變更所有使用者配置檔的位置。 呼叫 WlanGetSecuritySettings 以判斷變更所有使用者配置檔位置所需的實際用戶權力。

若要在命令行設定配置檔位置，請使用 netsh wlan set profileorder 命令。 如需詳細資訊，請參閱 無線區域網路的 Netsh 命令 (wlan) 。

Windows XP with SP3 和 Wireless LAN API for Windows XP with SP2： 臨機操作配置檔會出現在配置檔清單中的基礎結構配置檔後面。 如果您嘗試使用 WlanSetProfilePosition 在基礎結構配置檔之前放置臨機操作配置檔， WlanSetProfilePosition 呼叫將會成功，但無線零設定服務會重新排序配置檔清單，讓臨機操作配置檔位於所有基礎結構網路配置文件之後。

不支援客體配置檔、具有無線布建服務 (WPS) 驗證的配置檔，以及 Wi-Fi 受保護 Access-None (WPA-None) 驗證的配置檔。 出現在慣用配置檔清單中的任何這類配置檔，在配置檔清單中都有固定位置。 這表示無法使用 WlanSetProfilePosition 變更其位置，而且其位置不會受到其他配置檔的位置變更所影響。

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

如果 pInterfaceGuid 參數中指定的無線介面已從系統中移除 (已移除的 USB 無線適配卡，WlanSetProfilePosition 函式可能會因為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

WlanSetProfileList