Fungsi RegRenameKey (winreg.h)

Mengubah nama kunci registri yang ditentukan.

Sintaks

LSTATUS RegRenameKey(
  HKEY    hKey,
  LPCWSTR lpSubKeyName,
  LPCWSTR lpNewKeyName
);

Parameter

hKey

Handel ke kunci yang akan diganti namanya. Handel harus dibuka dengan hak akses KEY_WRITE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dikembalikan oleh fungsi RegCreateKeyEx atau RegOpenKeyEx , atau dapat menjadi salah satu Kunci yang Telah Ditentukan berikut:

• HKEY_CLASSES_ROOT
• HKEY_CURRENT_CONFIG
• HKEY_CURRENT_USER
• HKEY_LOCAL_MACHINE
• HKEY_USERS

lpSubKeyName

Nama subkunjuk yang akan diganti namanya. Kunci ini harus berupa subkunji kunci yang diidentifikasi oleh parameter hKey . Parameter ini juga dapat berupa NULL, dalam hal ini kunci yang diidentifikasi oleh parameter hKey akan diganti namanya.

lpNewKeyName

Nama baru kunci. Nama baru belum ada.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut. Kode kesalahan STATUS_ACCESS_DENIED menunjukkan bahwa pemanggil tidak memiliki hak akses yang diperlukan ke kunci registri atau subkunci yang ditentukan.

Keterangan

Fungsi ini dapat digunakan untuk mengganti nama seluruh subtree registri. Pemanggil harus memiliki akses KEY_CREATE_SUB_KEY ke induk kunci yang ditentukan dan akses DELETE ke seluruh subtree yang diganti namanya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

RegCopyTree

Fungsi Registri

Gambaran Umum Registri

SECURITY_ATTRIBUTES