RtlCheckRegistryKey-Funktion (wdm.h)

Die RtlCheckRegistryKey-Routine überprüft, ob ein angegebener benannter Schlüssel in der Registrierung vorhanden ist.

Syntax

NTSYSAPI NTSTATUS RtlCheckRegistryKey(
  [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_CONTROL	Pfad ist relativ zu \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_DEVICEMAP	Der Pfad ist relativ zu \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_SERVICES	Der Pfad ist relativ zu \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_USER	Der Pfad ist relativ zu den Registrierungseinstellungen für den aktuellen Benutzer. (Für einen Systemprozess ist dies \Users\. Standard.) Dies entspricht HKEY_CURRENT_USER im Benutzermodus.
RTL_REGISTRY_WINDOWS_NT	Der Pfad ist relativ zu \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_HANDLE	Dieser Wert sollte nicht an diese Routine übergeben werden. Trotz der Redundanz einer Überprüfung auf das Vorhandensein eines bereits geöffneten Schlüssels hat dies den Nebeneffekt, dass das übergebene Handle geschlossen wird.

[in] Path

Gibt den Registrierungspfad gemäß dem RelativeTo-Wert an. Wenn RTL_REGISTRY_HANDLE festgelegt ist, ist Path ein Handle, das direkt verwendet werden soll.

Rückgabewert

Wenn der angegebene benannte Schlüssel in der Registrierung entlang des angegebenen relativen Pfads vorhanden ist, gibt RtlCheckRegistryKey STATUS_SUCCESS zurück.

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

Weitere Informationen

RtlQueryRegistryValues