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 |