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 |