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

See Also

Reference

Registry Functions
RegSetValueEx

Other Resources

State and Notifications Broker