Fungsi RegUnLoadKeyA (winreg.h)
Membongkar kunci registri yang ditentukan dan subkuntangnya dari registri.
Aplikasi yang mencadangkan atau memulihkan status sistem termasuk file sistem dan sarang registri harus menggunakan Layanan Menyalin Bayangan Volume alih-alih fungsi registri.
Sintaks
LSTATUS RegUnLoadKeyA(
[in] HKEY hKey,
[in, optional] LPCSTR 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_USERS HKEY_LOCAL_MACHINE
[in, optional] lpSubKey
Nama subkunji yang akan dibongkar. Kunci yang dirujuk oleh parameter lpSubKey harus dibuat dengan menggunakan fungsi RegLoadKey .
Nama kunci tidak peka huruf besar/kecil.
Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.
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
Fungsi ini menghapus sarang dari registri tetapi tidak mengubah file yang berisi informasi registri. Hive adalah isi diskrit kunci, subkunci, dan nilai yang berakar di bagian atas hierarki registri.
Proses panggilan harus memiliki hak SE_RESTORE_NAME dan SE_BACKUP_NAME pada komputer tempat registri berada. Untuk informasi selengkapnya, lihat Menjalankan dengan Hak Istimewa Khusus.
Catatan
Header winreg.h mendefinisikan RegUnLoadKey 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
| 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 |