RegCloseKey-Funktion (winreg.h)
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 |