Fungsi RegCloseKey (winreg.h)

Artikel
08/27/2023

Menutup handel ke kunci registri yang ditentukan.

Sintaks

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

Parameter

[in] hKey

Handel ke kunci yang terbuka untuk ditutup. Handel harus dibuka oleh fungsi RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, RegOpenKeyTransacted, atau RegConnectRegistry .

Menampilkan nilai

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

Handel untuk kunci yang ditentukan tidak boleh digunakan setelah ditutup, karena tidak akan valid lagi. Handel kunci tidak boleh dibiarkan terbuka lebih lama dari yang diperlukan.

Fungsi RegCloseKey tidak selalu menulis informasi ke registri sebelum kembali; dibutuhkan waktu selama beberapa detik agar cache dibersihkan ke hard disk. Jika aplikasi harus secara eksplisit menulis informasi registri ke hard disk, aplikasi dapat menggunakan fungsi RegFlushKey . Namun, RegFlushKey menggunakan banyak sumber daya sistem dan harus dipanggil hanya jika perlu.

Contoh

Misalnya, lihat Menghapus Kunci dengan Subkundang.

Persyaratan


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