RegDeleteKeyEx

RegDeleteKeyEx deletes a subkey and its values from the registry. See RegDeleteKey for a basic version of this function.

Syntax

Copy

LONG RegDeleteKeyEx(
    HKEY        hKey,
    LPCTSTR     lpSubKey, 
    REGSAM      samDesired, 
    DWORD       Reserved     
  );

Parameters

hKey

A handle that can be one of the following predefined keys:

HKEY_LOCAL_MACHINE

HKEY_USERS

lpSubKey

The name of the key to be deleted. This key must be a subkey of the key specified by the value of the hKey parameter, but it cannot have subkeys. The value of this parameter cannot be NULL. Key names are case sensitive.

samDesired

Ignored.

Reserved

This parameter is reserved and must be zero.

Return Value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is a nonzero error code.

Remarks

A deleted key is not removed until the last handle to it is closed.

Requirements

Minimum supported version	Header	Library
eRTOS 1.0 SDK	windows.h	rtkrnl.lib