RegDeleteKeyTransactedA-Funktion (winreg.h)
Löscht einen Unterschlüssel und seine Werte aus der angegebenen plattformspezifischen Ansicht der Registrierung als transaktionierten Vorgang. Beachten Sie, dass bei Schlüsselnamen die Groß-/Kleinschreibung nicht beachtet wird.
Syntax
LSTATUS RegDeleteKeyTransactedA(
[in] HKEY hKey,
[in] LPCSTR lpSubKey,
[in] REGSAM samDesired,
DWORD Reserved,
[in] HANDLE hTransaction,
PVOID pExtendedParameter
);
Parameter
[in] hKey
Ein Handle für einen geöffneten Registrierungsschlüssel. Die Zugriffsrechte dieses Schlüssels wirken sich nicht auf den Löschvorgang aus. Weitere Informationen zu Zugriffsrechten finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.
Dieses Handle wird von der RegCreateKeyEx-, RegCreateKeyTransacted-, RegOpenKeyEx- oder RegOpenKeyTransacted-Funktion zurückgegeben. Es kann auch einer der folgenden vordefinierten Schlüssel sein:
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_USERS
[in] lpSubKey
Der Name des zu löschenden Schlüssels. Dieser Schlüssel muss ein Unterschlüssel des Schlüssels sein, der durch den Wert des hKey-Parameters angegeben wird.
Die Funktion öffnet den Unterschlüssel mit dem Zugriffsrecht DELETE.
Bei Schlüsselnamen wird die Groß-/Kleinschreibung nicht beachtet.
Der Wert dieses Parameters darf nicht NULL sein.
[in] samDesired
Eine Zugriffsmaske gibt die plattformspezifische Ansicht der Registrierung an.
Wert | Bedeutung |
---|---|
|
Löschen Sie den Schlüssel aus der 32-Bit-Registrierungsansicht. |
|
Löschen Sie den Schlüssel aus der 64-Bit-Registrierungsansicht. |
Reserved
Dieser Parameter ist reserviert und muss null sein.
[in] hTransaction
Ein Handle für eine aktive Transaktion. Dieses Handle wird von der CreateTransaction-Funktion zurückgegeben.
pExtendedParameter
Dieser Parameter ist reserviert und muss NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in Winerror.h definierter Fehlercode ungleich null. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Hinweise
Ein gelöschter Schlüssel wird erst entfernt, wenn das letzte Handle für ihn geschlossen wurde.
Auf WOW64 zeigen 32-Bit-Anwendungen eine Registrierungsstruktur an, die von der Registrierungsstruktur getrennt ist, die 64-Bit-Anwendungen anzeigen. Mit dieser Funktion kann eine Anwendung einen Eintrag in der alternativen Registrierungsansicht löschen.
Der zu löschende Unterschlüssel darf keine Unterschlüssel aufweisen. Um einen Schlüssel und alle seine Unterschlüssel zu löschen, müssen Sie die Unterschlüssel aufzählen und einzeln löschen. Verwenden Sie zum rekursiven Löschen von Schlüsseln die RegDeleteTree - oder SHDeleteKey-Funktion .
Wenn die Funktion erfolgreich ist, entfernt RegDeleteKeyTransacted den angegebenen Schlüssel aus der Registrierung. Der gesamte Schlüssel, einschließlich aller zugehörigen Werte, wird entfernt. Um die gesamte Struktur als transaktionierten Vorgang zu entfernen, verwenden Sie die RegDeleteTree-Funktion mit einem Handle, das von RegCreateKeyTransacted oder RegOpenKeyTransacted zurückgegeben wird.
Hinweis
Der winreg.h-Header definiert RegDeleteKeyTransacted 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
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winreg.h (Windows.h einschließen) |
Bibliothek | Advapi32.lib |
DLL | Advapi32.dll |
Weitere Informationen
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