Fungsi RegDeleteKeyW (winreg.h)

Artikel
03/04/2024

Menghapus subkunjud 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 RegDeleteKeyEx .

Sintaks

LSTATUS RegDeleteKeyW(
  [in] HKEY    hKey,
  [in] LPCWSTR lpSubKey
);

Parameter

[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 berupa subkun tangan kunci yang diidentifikasi hKey , tetapi tidak dapat memiliki subkunjud. Parameter ini tidak boleh NULL.

Fungsi ini membuka subkunjuk dengan hak akses DELETE.

Nama kunci tidak peka huruf besar/kecil.

Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Untuk mendapatkan deskripsi umum kesalahan, Anda bisa menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM.

Keterangan

Kunci yang dihapus tidak dihapus hingga handel terakhir ditutup.

Subkunjud yang akan dihapus tidak boleh memiliki subkunjud. Untuk menghapus kunci dan semua subkuncinya, Anda perlu menghitung subkunci dan menghapusnya satu per satu. Untuk menghapus kunci secara rekursif, gunakan fungsi RegDeleteTree atau SHDeleteKey .

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Menghapus Kunci dengan Subkuncar.

Catatan

Header winreg.h mendefinisikan RegDeleteKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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.

Persyaratan

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