RegDelete

Löscht einen Unterschlüssel oder Wert aus der Registry.

Neue Syntax [v1.1.21+]

RegDelete, SchlüsselName , WertName

Parameter

SchlüsselName

Der vollständige Name des Registry-Schlüssels, z.B. HKLM\Software\BeliebigeApp.

Der Name muss entweder mit HKEY_LOCAL_MACHINE (oder HKLM), HKEY_USERS (oder HKU), HKEY_CURRENT_USER (oder HKCU), HKEY_CLASSES_ROOT (oder HKCR) oder HKEY_CURRENT_CONFIG (oder HKCC) beginnen.

Um auf eine Remote-Registry zuzugreifen, stellen Sie den Computernamen und einen Doppelpunkt (oder in [v1.1.21+] einen umgekehrten Schrägstrich) voran, z.B. \\workstation01\HKLM.

WertName

Wenn leer oder weggelassen, wird der komplette SchlüsselName gelöscht. Andernfalls geben Sie den Namen des zu löschenden Wertes an. Um den Standardwert von SchlüsselName zu löschen - das ist der Wert, den RegEdit als "(Standard)" anzeigt - geben Sie AHK_DEFAULT für diesen Parameter an.

Alte Syntax

Veraltet: Diese Syntax ist nicht für neue Skripte empfohlen. Verwenden Sie stattdessen die oben beschriebene neue Syntax.

RegDelete, RootSchlüssel, UnterSchlüssel , WertName

Parameter

RootSchlüssel

Muss entweder HKEY_LOCAL_MACHINE (oder HKLM), HKEY_USERS (oder HKU), HKEY_CURRENT_USER (oder HKCU), HKEY_CLASSES_ROOT (oder HKCR) oder HKEY_CURRENT_CONFIG (oder HKCC) sein.

Um auf eine Remote-Registry zuzugreifen, stellen Sie den Computernamen und einen Doppelpunkt (oder in [v1.1.21+] einen umgekehrten Schrägstrich) voran, z.B. \\workstation01\HKLM.

UnterSchlüssel

Name des Unterschlüssels, z.B. Software\BeliebigeApp.

WertName

Wenn leer oder weggelassen, wird der komplette UnterSchlüssel gelöscht. Andernfalls geben Sie den Namen des zu löschenden Wertes an. Um den Standardwert von UnterSchlüssel zu löschen - das ist der Wert, den RegEdit als "(Standard)" anzeigt - geben Sie AHK_DEFAULT für diesen Parameter an.

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.

A_LastError wird auf das Ergebnis der Systemfunktion GetLastError() gesetzt.

Bemerkungen

Warnung: Das Löschen von Registry-Einträgen kann zu erheblichen Problemen führen - bitte seien Sie vorsichtig!

Mit der Registry-Schleife können mehrere Registry-Schlüssel und -Werte abgerufen und bearbeitet werden.

In den Bemerkungen zur Registry-Schleife finden Sie Informationen darüber, wie auf die Registry eines Remote-Computers zugegriffen werden kann.

Um Einträge aus den 64-Bit-Bereichen der Registry mit einem 32-Bit-Skript (oder umgekehrt) zu löschen, verwenden Sie SetRegView.

RegRead, RegWrite, Registry-Schleife, SetRegView, IniDelete

Beispiele

Neue Syntax vs. alte Syntax.

Trotz unterschiedlicher Syntax haben beide Beispiele den gleichen Effekt: Sie löschen einen Wert aus der Registry.

RegDelete, HKEY_LOCAL_MACHINE\Software\BeliebigeApp, Testwert
RegDelete, HKEY_LOCAL_MACHINE, Software\BeliebigeApp, Testwert