UID

title

description

old-location

tech.root

ms.date

keywords

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

f1_keywords

topic_type

api_type

api_location

api_name

NF:wdm.RtlCreateRegistryKey

RtlCreateRegistryKey function (wdm.h)

The RtlCreateRegistryKey routine adds a key object in the registry along a given relative path.

kernel\rtlcreateregistrykey.htm

kernel

04/30/2018

RtlCreateRegistryKey function

RtlCreateRegistryKey, RtlCreateRegistryKey routine [Kernel-Mode Driver Architecture], k109_9a163bcc-501d-453b-b426-a4267d04135c.xml, kernel.rtlcreateregistrykey, wdm/RtlCreateRegistryKey

wdm.h

Wdm.h, Ntddk.h, Ntifs.h

Universal

Available in Windows 2000 and later versions of Windows.

NtosKrnl.lib

NtosKrnl.exe

PASSIVE_LEVEL

Windows

RtlCreateRegistryKey

wdm/RtlCreateRegistryKey

APIRef

kbSyntax

DllExport

NtosKrnl.exe

RtlCreateRegistryKey

RtlCreateRegistryKey function

-description

The RtlCreateRegistryKey routine adds a key object in the registry along a given relative path.

-parameters

-param RelativeTo [in]

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. (For a system process, this is \Users\.Default.)

-param Path [in]

Specifies the registry path according to the RelativeTo value.

-returns

RtlCreateRegistryKey returns STATUS_SUCCESS if the key is created.

-remarks

RtlCreateRegistryKey creates only the keys that you specify. It does not create missing keys in the path to the specified key. If any keys in the path are missing, the call will fail. To ensure that all keys in the path exist, you must call RtlCreateRegistryKey once for each key in the path.