Deletes a subkey or value from the registry.
RegDelete, RootKey, SubKey [, ValueName] |
Parameters
RootKey | Must be either HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_CURRENT_USER, HKEY_CLASSES_ROOT, or HKEY_CURRENT_CONFIG (or the abbreviations for each of these, such as HKLM). To access a remote registry, prepend the computer name and a colon, as in this example: \\workstation01:HKEY_LOCAL_MACHINE |
SubKey | The name of the subkey (e.g. Software\SomeApplication). |
ValueName | The name of the value to delete. If omitted, the entire SubKey will be deleted. To delete Subkey's default value -- which is the value displayed as "(Default)" by RegEdit -- use the phrase AHK_DEFAULT for this parameter. |
ErrorLevel
ErrorLevel is set to 1 if there was a problem or 0 otherwise.
Remarks
Deleting from the registry is potential dangerous - please exercise caution!
To retrieve and operate upon multiple registry keys or values, consider using a registry-loop.
For details about how to access the registry of a remote computer, see the remarks in registry-loop.
Related
RegRead, RegWrite, Registry-loop, IniDelete
Example
RegDelete, HKEY_LOCAL_MACHINE, Software\SomeApplication, TestValue