Fungsi WlanRenameProfile (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanRenameProfile mengganti nama profil yang ditentukan.

Sintaks

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

Parameter

[in] hClientHandle

Handel sesi klien, diperoleh dari panggilan sebelumnya ke fungsi WlanOpenHandle .

[in] pInterfaceGuid

GUID antarmuka.

[in] strOldProfileName

Nama profil yang akan diubah.

[in] strNewProfileName

Nama baru profil.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan mungkin merupakan salah satu kode pengembalian berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID PARAMETER	hClientHandle adalah NULL atau tidak valid, pInterfaceGuid adalah NULL, strOldProfileName adalah NULL, strNewProfileName adalah NULL, atau pReserved bukan NULL.
ERROR_INVALID_HANDLE	Handel hClientHandle tidak ditemukan dalam tabel handel.
ERROR_NOT_FOUND	Profil yang ditentukan oleh strOldProfileName tidak ditemukan di penyimpanan profil.
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai untuk mengganti nama profil.
ERROR_NOT_SUPPORTED	Fungsi ini dipanggil dari platform yang tidak didukung. Nilai ini akan dikembalikan jika fungsi ini dipanggil dari Windows XP dengan SP3 atau Wireless LAN API untuk Windows XP dengan klien SP2.
RPC_STATUS	Berbagai kode kesalahan.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h (termasuk Wlanapi.h)
Pustaka	Wlanapi.lib
DLL	Wlanapi.dll

Lihat juga

WlanDeleteProfile

WlanGetProfile

WlanSetProfile

Bagikan melalui