SHDeleteValue function

Deletes a named value from the specified registry key.

Syntax

LSTATUS SHDeleteValue(
   HKEY    hkey,
   LPCTSTR pszSubKey,
   LPCTSTR pszValue
);

Parameters

hkey

Type: HKEY

A handle to the currently open key, or any of the following predefined values.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

pszSubKey

Type: LPCTSTR

The address of a null-terminated string specifying the name of the subkey for which to change the value.

pszValue

Type: LPCTSTR

The address of the value to be deleted.

Return value

Type: LSTATUS

Returns ERROR_SUCCESS if successful, or a nonzero error code defined in Winerror.h otherwise. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to retrieve a generic description of the error.

Requirements