Fungsi RegUnLoadKeyW (winreg.h)

Artikel
11/20/2024

Membongkar kunci registri yang ditentukan dan subkuntangnya dari registri.

Aplikasi yang mencadangkan atau memulihkan status sistem termasuk file sistem dan sarang registri harus menggunakan Volume Shadow Copy Service alih-alih fungsi registri.

Sintaksis

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

Parameter

[in] hKey

Handel ke kunci registri yang akan dibongkar. Parameter ini dapat menjadi handel yang dikembalikan oleh panggilan ke fungsi RegConnectRegistry atau salah satu handel yang telah ditentukan sebelumnya berikut:

HKEY_LOCAL_MACHINE
HKEY_USERS

[in, optional] lpSubKey

Nama subkunjuk yang akan dibongkar. Kunci yang dimaksud oleh parameter lpSubKey harus dibuat dengan menggunakan fungsi RegLoadKey.

Nama kunci tidak peka huruf besar/kecil.

Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai pengembalian adalah kode kesalahan nonzero yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.

Komentar

Fungsi ini menghapus sarang dari registri tetapi tidak mengubah file yang berisi informasi registri. Hive adalah isi kunci, subkunci, dan nilai diskrit yang berakar di bagian atas hierarki registri.

Proses panggilan harus memiliki hak istimewa SE_RESTORE_NAME dan SE_BACKUP_NAME pada komputer tempat registri berada. Untuk informasi selengkapnya, lihat Berjalan dengan Hak Istimewa Khusus.

Nota

Header winreg.h mendefinisikan RegUnLoadKey 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.

Persyaratan

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

Lihat juga

RegConnectRegistry

regDeleteKey

RegLoadKey

RegRestoreKey

Fungsi Registri

Gambaran Umum Registri

Bagikan melalui