RtlWriteRegistryValue-Funktion (wdm.h)

Artikel
08/08/2023

Die RtlWriteRegistryValue-Routine schreibt vom Aufrufer bereitgestellte Daten entlang des angegebenen relativen Pfads unter dem angegebenen Wertnamen in die Registrierung.

Syntax

NTSYSAPI NTSTATUS RtlWriteRegistryValue(
  [in]           ULONG  RelativeTo,
  [in]           PCWSTR Path,
  [in]           PCWSTR ValueName,
  [in]           ULONG  ValueType,
  [in, optional] PVOID  ValueData,
  [in]           ULONG  ValueLength
);

Parameter

[in] RelativeTo

Gibt an , ob Path ein absoluter Registrierungspfad ist oder relativ zu einem vordefinierten Pfad ist.

Wert	Bedeutung
RTL_REGISTRY_ABSOLUTE	Path ist ein absoluter Registrierungspfad.
RTL_REGISTRY_SERVICES	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	Pfad ist relativ zu \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP	Pfad ist relativ zu \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER	Pfad ist relativ zu \Registry\User\CurrentUser. (Bei einem Systemprozess ist dies \Users\. Standard.)
RTL_REGISTRY_OPTIONAL	Gibt an, dass der Schlüssel, auf den dieser Parameter verweist, und der Path-Parameter optional sind.
RTL_REGISTRY_HANDLE	Gibt an, dass der Path-Parameter tatsächlich ein zu verwendende Registrierungshandle ist. Dieser Wert ist optional.

[in] Path

Zeiger auf einen absoluten Registrierungspfad oder einen Pfad relativ zum bekannten Speicherort, der durch den RelativeTo-Parameter angegeben wird. Wenn das RTL_REGISTRY_HANDLE-Flag angegeben ist, ist dieser Parameter ein Registrierungshandle für einen bereits geöffneten Schlüssel, der direkt verwendet werden soll.

[in] ValueName

Zeiger auf den Namen eines Unterschlüssels oder Werteintrags, der in die Registrierung geschrieben werden soll.

[in] ValueType

Gibt einen REG_XXX-Wert an, der den Typ des ValueName-Parameters bestimmt. Eine Liste der möglichen Werte finden Sie im Type-Parameter von ZwSetValueKey.

[in, optional] ValueData

Zeiger auf den Namen eines Unterschlüssels oder von Werten für dessen Werteinträge (oder beides), die in die Registrierung geschrieben werden sollen.

[in] ValueLength

Gibt die Anzahl der Bytes von ValueData an, die in die Registrierung geschrieben werden sollen.

Rückgabewert

RtlWriteRegistryValue gibt die status des Vorgangs zurück, entweder STATUS_SUCCESS oder einen Fehler status.

Hinweise

Wenn der angegebene Schlüssel nicht vorhanden ist, versucht die Routine, den Schlüssel zu erstellen. Damit dieser Versuch erfolgreich ist, muss der neue Schlüssel ein direkter Unterschlüssel des Schlüssels sein, auf den vom Path-Parameter verwiesen wird, und der Schlüssel, auf den Path verweist, muss für KEY_CREATE_SUB_KEY Zugriff geöffnet worden sein.

Anforderungen

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