RegUnLoadKeyA-Funktion (winreg.h)
Entladen Sie den angegebenen Registrierungsschlüssel und die zugehörigen Unterschlüssel aus der Registrierung.
Anwendungen, die den Systemstatus sichern oder wiederherstellen, einschließlich Systemdateien und Registrierungsstruktur, sollten den Volume Shadow Copy Service anstelle der Registrierungsfunktionen verwenden.
Syntax
LSTATUS RegUnLoadKeyA(
[in] HKEY hKey,
[in, optional] LPCSTR lpSubKey
);
Parameter
[in] hKey
Ein Handle für den Registrierungsschlüssel, der entladen werden soll. Dieser Parameter kann ein Handle sein, das von einem Aufruf von RegConnectRegistry Funktion oder einem der folgenden vordefinierten Handles zurückgegeben wird:
HKEY_LOCAL_MACHINEHKEY_USERS
[in, optional] lpSubKey
Der Name des zu entladenden Unterschlüssels. Der schlüssel, auf den der lpSubKey Parameter verweist, muss mithilfe der RegLoadKey--Funktion erstellt worden sein.
Bei Schlüsselnamen wird die Groß-/Kleinschreibung nicht beachtet.
Weitere Informationen finden Sie unter Registrierungselementgrößenbeschränkungen.
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 FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine allgemeine Beschreibung des Fehlers zu erhalten.
Bemerkungen
Diese Funktion entfernt eine Struktur aus der Registrierung, ändert aber nicht die Datei, die die Registrierungsinformationen enthält. Eine Struktur ist ein separater Textkörper von Schlüsseln, Unterschlüsseln und Werten, die oben in der Registrierungshierarchie verwurzelt sind.
Der Aufrufvorgang muss über die SE_RESTORE_NAME und SE_BACKUP_NAME Berechtigungen auf dem Computer verfügen, auf dem sich die Registrierung befindet. Weitere Informationen finden Sie unter Ausführen mit speziellen Rechten.
Anmerkung
Der winreg.h-Header definiert RegUnLoadKey als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winreg.h (enthalten Windows.h) |
| Library | Advapi32.lib |
| DLL- | Advapi32.dll |