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 RegDeleteValue(
    HKEY hKey,
    LPCTSTR lpValueName
);

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 RegSetValueEx is removed.

Return Values

ERROR_SUCCESS

Success.

A nonzero status code defined in RTWIN32.H

Failure. For extended error information, see GetLastError

Requirements

This function operates in the real-time portion of your application.

See Also

iwin32 API, iwin32 Overview