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 |