Fungsi RegDeleteKeyA (winreg.h)
Menghapus subkunjuk dan nilainya. Perhatikan bahwa nama kunci tidak peka huruf besar/kecil.
Windows 64-bit: Pada WOW64, aplikasi 32-bit melihat pohon registri yang terpisah dari pohon registri yang dilihat aplikasi 64-bit. Untuk mengaktifkan aplikasi untuk menghapus entri dalam tampilan registri alternatif, gunakan fungsi
LSTATUS RegDeleteKeyA(
[in] HKEY hKey,
[in] LPCSTR lpSubKey
);
[in] hKey
Handel ke kunci registri terbuka. Hak akses kunci ini tidak memengaruhi operasi penghapusan. Untuk informasi selengkapnya tentang hak akses, 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
[in] lpSubKey
Nama kunci yang akan dihapus. Ini harus menjadi subkuntang kunci yang hKey mengidentifikasi, tetapi tidak dapat memiliki subkunjuk. Parameter ini tidak dapat null.
Fungsi membuka subkunjuk dengan akses DELETE ke kanan.
Nama kunci tidak peka huruf besar/kecil.
Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.
Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.
Jika fungsi gagal, nilai pengembalian adalah kode kesalahan nonzero yang ditentukan dalam Winerror.h. Untuk mendapatkan deskripsi umum tentang kesalahan, Anda bisa menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM.
Kunci yang dihapus tidak dihapus sampai handel terakhir ditutup.
Subkunjuk yang akan dihapus tidak boleh memiliki subkunjuk. Untuk menghapus kunci dan semua subkuncinya, Anda perlu menghitung subkunci dan menghapusnya satu per satu. Untuk menghapus kunci secara rekursif, gunakan fungsi
Untuk contoh yang menggunakan fungsi ini, lihat Menghapus Kunci dengan Subkunia.
Catatan
Pada versi Windows lama, API ini juga diekspos oleh kernel32.dll.
Catatan
Header winreg.h mendefinisikan RegDeleteKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
| Syarat | Nilai |
|---|---|
| klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Platform Target |
Windows |
| Header |
winreg.h (termasuk Windows.h) |
| Pustaka |
Advapi32.lib |
| DLL |
Advapi32.dll |
Fungsi Registri
Gambaran Umum