RtlCreateRegistryKey-Funktion (wdm.h)

Artikel
02/27/2024

Die RtlCreateRegistryKey-Routine fügt ein Schlüsselobjekt in der Registrierung entlang eines bestimmten relativen Pfads hinzu.

Syntax

NTSYSAPI NTSTATUS RtlCreateRegistryKey(
  [in] ULONG RelativeTo,
  [in] PWSTR Path
);

Parameter

[in] RelativeTo

Gibt an, ob Path ein absoluter Registrierungspfad oder relativ zu einem vordefinierten Schlüsselpfad ist.

Wert	Bedeutung
RTL_REGISTRY_ABSOLUTE	Path ist ein absoluter Registrierungspfad.
RTL_REGISTRY_SERVICES	Der Pfad ist relativ zu \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL	Pfad ist relativ zu \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT	Der Pfad ist relativ zu \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP	Der Pfad ist relativ zu \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER	Der Pfad ist relativ zu \Registry\User\CurrentUser. (Für einen Systemprozess ist dies \Users\. Standard.)

[in] Path

Gibt den Registrierungspfad gemäß dem RelativeTo-Wert an.

Rückgabewert

RtlCreateRegistryKey gibt STATUS_SUCCESS zurück, wenn der Schlüssel erstellt wird.

Hinweise

RtlCreateRegistryKey erstellt nur die Schlüssel, die Sie angeben. Fehlende Schlüssel im Pfad zum angegebenen Schlüssel werden nicht erstellt. Wenn Schlüssel im Pfad fehlen, schlägt der Aufruf fehl. Um sicherzustellen, dass alle Schlüssel im Pfad vorhanden sind, müssen Sie RtlCreateRegistryKey einmal für jeden Schlüssel im Pfad aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL