Funzione RtlWriteRegistryValue (wdm.h)

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

Vedi anche

RtlCheckRegistryKey

RtlCreateRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

ZwCreateKey

ZwOpenKey

ZwSetValueKey