RegistryDeleteValue

Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.

SalBoolean RegistryDeleteValue ( SalNumber hKey,
		              SalString sSubKey,
		              SalString sValueName )

The RegistryDeleteValue method deletes a key value from the Windows registry.

Parameters

Name Description
SalNumber hKey Identifies a currently open key or any of the following predefined reserved handle values: Const.HKEY_CLASSES_ROOT, Const.HKEY_CURRENT_USER, Const.HKEY_LOCAL_MACHINE, Const.HKEY_USERS
SalString sSubKey Name of subkey to delete the value from. Use the "backslash" character (\) to denote multiple levels in the subkey.
SalString sValueName Name of value to delete.

Returns

The return value is TRUE if the key value was successfully deleted, FALSE otherwise

Comments

You can only use this method to delete registry key values of the REG_SZ (null-terminated string) type.

Example

Call Profile.RegistryDeleteValue( HKEY_CLASSES_ROOT,
		     '.ifm', strNULL )
Call Profile.RegistryDeleteValue( HKEY_CLASSES_ROOT,
            'ifm_auto_file\\shell', 'Enable' )
C# code (RegistryDeleteValue in turn calls _ProfileRegistryDeleteValue)
Ext._ProfileRegistryDeleteValue(Const.HKEY_CURRENT_USER,
Const.REGISTRY_KEY_PersonalProfile + Vis.StrSubstitute(sSection, ".", "\\"), sEntry);