RtlDeleteRegistryValue

RtlDeleteRegistryValue

NTSTATUS
RtlDeleteRegistryValue(
IN ULONG RelativeTo,
IN PWSTR Path,
IN PWSTR ValueName
);

RtlDeleteRegistryValue removes the specified entry name and the associated values from the registry along the given relative path.

Parameters

RelativeTo

Specifies whether Path is an absolute registry path or is relative to a predefined key path as one of the following:

Value	Meaning
RTL_REGISTRY_ABSOLUTE
	Path is an absolute registry path.
RTL_REGISTRY_SERVICES
	Path is relative to \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL
	Path is relative to \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT
	Path is relative to \Registry\Machine\Software\Microsoft\ Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP
	Path is relative to \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER
	Path is relative to \Registry\User\CurrentUser.
RTL_REGISTRY_OPTIONAL
	Specifies that the key referenced by this parameter and the Path parameter are optional.
RTL_REGISTRY_HANDLE
	Specifies that the Path parameter is actually a registry handle to use. This value is optional.

Path

Specifies the registry path according to the RelativeTo value. If RTL_REGISTRY_HANDLE is set, Path is a handle to be used directly.

ValueName

Points to the value name to be removed from the registry.

Return Value

RtlDeleteRegistryValue returns STATUS_SUCCESS if the value entry was deleted.

Callers of RtlDeleteRegistryValue must be running at IRQL PASSIVE_LEVEL.