Share via


RegDeleteValue

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

Other Resources

State and Notifications Broker