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 |