wlanRenameProfile 函数 (wlanapi.h)

  • 项目

WlanRenameProfile 函数重命名指定的配置文件。

语法

DWORD WlanRenameProfile(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strOldProfileName,
  [in] LPCWSTR    strNewProfileName,
       PVOID      pReserved
);

参数

[in] hClientHandle

客户端的会话句柄，由上一次对 WlanOpenHandle 函数的调用获取。

[in] pInterfaceGuid

接口的 GUID。

[in] strOldProfileName

要更改的配置文件名称。

[in] strNewProfileName

配置文件的新名称。

pReserved

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

返回值

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

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

返回代码 说明
ERROR_INVALID 参数
 hClientHandle 为 NULL 或无效， pInterfaceGuid 为 NULL， strOldProfileName 为 NULL， strNewProfileName 为 NULL，或 pReserved 不为 NULL。
ERROR_INVALID_HANDLE
 在句柄表中找不到句柄 hClientHandle 。
ERROR_NOT_FOUND
 在配置文件存储中找不到 strOldProfileName 指定的配置文件。
ERROR_ACCESS_DENIED
 调用方没有足够的权限重命名配置文件。
ERROR_NOT_SUPPORTED
 此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数，则将返回此值。
RPC_STATUS
 各种错误代码。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h (包括 Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll

另请参阅

WlanDeleteProfile

WlanGetProfile

WlanSetProfile