共用方式為

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 PARAMETER
 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 或 Windows XP 搭配 SP2 用戶端的無線區域網路 API 呼叫，則會傳回此值。
RPC_STATUS
 各種錯誤碼。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll

另請參閱

WlanDeleteProfile

WlanGetProfile

WlanSetProfile