Previous - regWrite Section Home - Registry and INI Next - regListKey


regDelete ( )

Deletes a value or subkey from the windows registry.

Usage:

regDelete (object me, string key, string subkey, string valueName )

Parameters:

key (string) - The predefined root key. The possible Values are:

"HKEY_CLASSES_ROOT"
"HKEY_CURRENT_USER"
"HKEY_LOCAL_MACHINE"
"HKEY_USERS"
"HKEY_DYN_DATA"

subkey (string) - The path containing the string to open the registry value

valueName (string) - The name of value to delete. Leave parameter EMPTY to delete the entire subkey

Returns:

(integer) - The success code

Example 1:

-- this deletes a value and value name pair
xtRose = xtra("Rosetta").new( )
bSuccess = xtRose.regDelete( "HKEY_CURRENT_USER", "Software\Calu", "Author" )

Example 2:

--  deleting an entire subkey
xtRose = xtra("Rosetta").new( )
bSuccess = xtRose.regDelete( "HKEY_CURRENT_USER", "Software\Calu", EMPTY )

Notes:

Keys and Values are not deleted until all access to it have been closed.

The subkey to be deleted must not have subkeys. To delete a key and all its subkeys, use regListKey( ) to traverse the subkey list and delete them recursively.


Previous - regWrite Section Home - Registry and INI Next - regListKey