Funzione RtlWriteRegistryValue (wdm.h)

Articolo
08/08/2023

La routine RtlWriteRegistryValue scrive i dati forniti dal chiamante nel Registro di sistema lungo il percorso relativo specificato in corrispondenza del nome di valore specificato.

Sintassi

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

Parametri

[in] RelativeTo

Specifica se Path è un percorso assoluto del Registro di sistema o è relativo a un percorso predefinito come uno dei seguenti.

Valore	Significato
RTL_REGISTRY_ABSOLUTE	Path è un percorso assoluto del Registro di sistema.
RTL_REGISTRY_SERVICES	Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL	Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT	Il percorso è relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP	Il percorso è relativo a \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER	Il percorso è relativo a \Registry\User\CurrentUser. Per un processo di sistema, si tratta di \Users\. Impostazione predefinita.
RTL_REGISTRY_OPTIONAL	Specifica che la chiave a cui fa riferimento questo parametro e il parametro Path sono facoltativi.
RTL_REGISTRY_HANDLE	Specifica che il parametro Path è effettivamente un handle del Registro di sistema da utilizzare. Questo valore è facoltativo.

[in] Path

Puntatore a un percorso assoluto del Registro di sistema o a un percorso relativo alla posizione nota specificata dal parametro RelativeTo . Se viene specificato il flag RTL_REGISTRY_HANDLE, questo parametro è un handle del Registro di sistema per una chiave già aperta da usare direttamente.

[in] ValueName

Puntatore al nome di una sottochiave o di una voce valore da scrivere nel Registro di sistema.

[in] ValueType

Specifica un valore REG_XXX che determina il tipo del parametro ValueName . Per un elenco dei valori possibili, vedere il parametro Type di ZwSetValueKey.

[in, optional] ValueData

Puntatore al nome di una sottochiave o di valori per le relative voci di valore (o entrambe) da scrivere nel Registro di sistema.

[in] ValueLength

Specifica il numero di byte di ValueData da scrivere nel Registro di sistema.

Valore restituito

RtlWriteRegistryValue restituisce lo stato dell'operazione, STATUS_SUCCESS o uno stato di errore.

Commenti

Se la chiave specificata non esiste, la routine tenta di creare la chiave. Per questo tentativo di esito positivo, la nuova chiave deve essere una sottochiave diretta della chiave a cui fa riferimento il parametro Path e la chiave a cui fa riferimento Path deve essere stata aperta per l'accesso KEY_CREATE_SUB_KEY.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL