Freigeben über


RtlWriteRegistryValue-Funktion (wdm.h)

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

Weitere Informationen

RtlCheckRegistryKey

RtlCreateRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

ZwCreateKey

ZwOpenKey

ZwSetValueKey