wlanapi.h) (WlanSetProfilePosition 函数

  • 项目

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 结尾。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API： 提供的名称必须与从网络的 SSID 自动派生的配置文件名称匹配。 对于基础结构网络配置文件，必须为配置文件名称提供 SSID。 对于即席网络配置文件，提供的名称必须是即席网络的 SSID， -adhoc后跟 。

[in] dwPosition

指示配置文件应移动到的首选项列表中的位置。 0 (零) 对应于 WlanGetProfileList 函数返回的列表中的第一个配置文件。

pReserved

保留供将来使用。 必须设置为 NULL。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值可能是以下返回代码之一。

返回代码 说明
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
 各种错误代码。

注解

无法更改组策略配置文件的位置。

默认情况下，只有以管理员组成员身份登录的用户才能更改所有用户配置文件的位置。 调用 WlanGetSecuritySettings 以确定更改所有用户配置文件的位置所需的实际用户权限。

若要在命令行中设置配置文件位置，请使用 netsh wlan set profileorder 命令。 有关详细信息，请参阅 适用于无线局域网的 Netsh 命令 (wlan) 。

带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API： 临时配置文件显示在配置文件列表中的基础结构配置文件之后。 如果尝试使用 WlanSetProfilePosition 在基础结构配置文件之前定位临时配置文件， WlanSetProfilePosition 调用将成功，但无线零配置服务将对配置文件列表进行重新排序，使即席配置文件定位在所有基础结构网络配置文件之后。

不支持来宾配置文件、具有无线预配服务 (WPS) 身份验证的配置文件，以及具有 Wi-Fi Protected 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)
Library Wlanapi.lib
DLL Wlanapi.dll
可再发行组件 带有 SP2 的 Windows XP 无线 LAN API

另请参阅

WlanGetProfile

WlanGetProfileList

WlanSetProfile

WlanSetProfileList