SHDeleteKeyA-Funktion (shlwapi.h)
Löscht einen Unterschlüssel und alle zugehörigen Untergeordneten. Diese Funktion entfernt den Schlüssel und alle Werte des Schlüssels aus der Registrierung.
Syntax
LSTATUS SHDeleteKeyA(
[in] HKEY hkey,
[in, optional] LPCSTR pszSubKey
);
Parameter
[in] hkey
Typ: HKEY
Ein Handle für einen geöffneten Registrierungsschlüssel oder einen der folgenden vordefinierten Schlüssel:
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS
[in, optional] pszSubKey
Typ: LPCTSTR
Die Adresse einer NULL-beendeten Zeichenfolge, die den Namen des zu löschenden Schlüssels angibt.
Rückgabewert
Typ: LSTATUS
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen in Winerror.h definierten Nonzero-Fehlercode zurück. Sie können die FormatMessage-Funktion mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Hinweise
Alternativ können Sie die RegDeleteKey - oder RegDeleteTree-Funktion verwenden.
Hinweis
Der shlwapi.h-Header definiert SHDeleteKey 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
Bibliothek | Shlwapi.lib |
DLL | Shlwapi.dll (Version 4.71 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für