Fungsi RegCloseKey (winreg.h)

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

Lihat juga

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

RegFlushKey

RegOpenKeyEx

Fungsi Registri

Gambaran Umum Registri