RegCloseKey-Funktion (winreg.h)

Artikel
08/27/2023

Schließt ein Handle mit dem angegebenen Registrierungsschlüssel.

Syntax

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

Parameter

[in] hKey

Ein Handle für den geöffneten Schlüssel, der geschlossen werden soll. Das Handle muss von den Funktionen RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, RegOpenKeyTransacted oder RegConnectRegistry geöffnet worden sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Hinweise

Das Handle für einen angegebenen Schlüssel sollte nach dem Schließen nicht mehr verwendet werden, da es nicht mehr gültig ist. Schlüsselhandles sollten nicht länger als erforderlich geöffnet bleiben.

Die RegCloseKey-Funktion schreibt nicht unbedingt Informationen in die Registrierung, bevor sie zurückgegeben wird. Es kann bis zu mehreren Sekunden dauern, bis der Cache auf die Festplatte geleert wurde. Wenn eine Anwendung Registrierungsinformationen explizit auf die Festplatte schreiben muss, kann sie die RegFlushKey-Funktion verwenden. RegFlushKey verwendet jedoch viele Systemressourcen und sollte nur bei Bedarf aufgerufen werden.

Beispiele

Ein Beispiel finden Sie unter Löschen eines Schlüssels mit Unterschlüsseln.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winreg.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll