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 |