Fungsi RegDeleteKeyTransactedA (winreg.h)

Artikel
08/27/2023

Menghapus subkuntang dan nilainya dari tampilan khusus platform yang ditentukan dari registri sebagai operasi yang ditransaksikan. Perhatikan bahwa nama kunci tidak peka huruf besar/kecil.

Sintaks

LSTATUS RegDeleteKeyTransactedA(
  [in] HKEY   hKey,
  [in] LPCSTR lpSubKey,
  [in] REGSAM samDesired,
       DWORD  Reserved,
  [in] HANDLE hTransaction,
       PVOID  pExtendedParameter
);

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, RegCreateKeyTransacted, RegOpenKeyEx, atau RegOpenKeyTransacted . Ini juga bisa menjadi salah satu kunci yang telah ditentukan sebelumnya berikut:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in] lpSubKey

Nama kunci yang akan dihapus. Kunci ini harus berupa subkunjuk kunci yang ditentukan oleh nilai parameter hKey .

Fungsi membuka subkey dengan hak akses DELETE.

Nama kunci tidak peka huruf besar/kecil.

Nilai parameter ini tidak boleh NULL.

[in] samDesired

Masker akses menentukan tampilan registri khusus platform.

Nilai	Makna
KEY_WOW64_32KEY 0x0200	Hapus kunci dari tampilan registri 32-bit.
KEY_WOW64_64KEY 0x0100	Hapus kunci dari tampilan registri 64-bit.

Reserved

Parameter ini dicadangkan dan harus nol.

[in] hTransaction

Handel ke transaksi aktif. Handel ini dikembalikan oleh fungsi CreateTransaction .

pExtendedParameter

Parameter ini dicadangkan dan harus NULL.

Nilai kembali

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.

Keterangan

Kunci yang dihapus tidak dihapus sampai handel terakhir ditutup.

Pada WOW64, aplikasi 32-bit melihat pohon registri yang terpisah dari pohon registri yang dilihat aplikasi 64-bit. Fungsi ini memungkinkan aplikasi untuk menghapus entri dalam tampilan registri alternatif.

Sub-kunci 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 RegDeleteTree atau SHDeleteKey .

Jika fungsi berhasil, RegDeleteKeyTransacted akan menghapus kunci yang ditentukan dari registri. Seluruh kunci, termasuk semua nilainya, dihapus. Untuk menghapus seluruh pohon sebagai operasi yang ditransaksikan, gunakan fungsi RegDeleteTree dengan handel yang dikembalikan dari RegCreateKeyTransacted atau RegOpenKeyTransacted.

Catatan

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


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

Lihat juga

RegCreateKeyTransacted

RegOpenKeyTransacted

Fungsi Registri

Registry Redirector

Bagikan melalui