Removes a named value from the specified registry key.

The key identified by the hKey parameter must have been opened with KEY_SET_VALUE access (KEY_WRITE access includes KEY_SET_VALUE access).

LONG RtRegDeleteValue(
    HKEY hKey,            // handle to key
    LPCTSTR lpValueName   // address of value name
);

Parameters

hKey

Handle to a currently open key or any of the following predefined reserved handle values:

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
HKEY_PERFORMANCE_DATA

lpValueName

Pointer to a null-terminated string that names the value to remove. If this parameter is NULL or points to an empty string, the value set by RtRegSetValueEx is removed.

Return Values

ERROR_SUCCESS

Success.

A nonzero status code defined in RTWIN32.H

Failure.

Requirements

See Also

Registry system calls, RtRegSetValueEx