RtlCreateRegistryKey-Funktion (wdm.h)
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 |