RegDeleteValue
A version of this page is also available for
4/8/2010
This function removes a named value from the specified registry key.
A remote application interface (RAPI) version of this function exists called CeRegDeleteValue (RAPI).
Syntax
LONG RegDeleteValue(
HKEY hKey,
LPCWSTR lpValueName
);
Parameters
hKey
[in] Handle to a currently open key or any of the following predefined reserved handle values:- HKEY_LOCAL_MACHINE
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_USER
- HKEY_USERS
- lpValueName
[in] Pointer to a null-terminated string that names the value to remove. If this parameter is set to NULL or points to an empty string, the default value of the key is removed. A default value is created by calling the RegSetValueEx function with a NULL or empty string value name.
Return Value
ERROR_SUCCESS indicates success. A nonzero error code defined in Winerror.h indicates failure. To get a generic description of the error, call the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag set. The message resource is optional, so FormatMessage might fail.
Requirements
| Header | winreg.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Registry Functions
RegSetValueEx