Función RtlWriteRegistryValue (wdm.h)
La rutina RtlWriteRegistryValue escribe los datos proporcionados por el autor de la llamada en el registro a lo largo de la ruta de acceso relativa especificada en el nombre de valor especificado.
Sintaxis
NTSYSAPI NTSTATUS RtlWriteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName,
[in] ULONG ValueType,
[in, optional] PVOID ValueData,
[in] ULONG ValueLength
);
Parámetros
[in] RelativeTo
Especifica si Path es una ruta de acceso absoluta del Registro o es relativa a una ruta de acceso predefinida como una de las siguientes.
| Valor | Significado |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path es una ruta de acceso absoluta del Registro. |
| RTL_REGISTRY_SERVICES | La ruta de acceso es relativa a \Registry\Machine\System\CurrentControlSet\Services. |
| RTL_REGISTRY_CONTROL | La ruta de acceso es relativa a \Registry\Machine\System\CurrentControlSet\Control. |
| RTL_REGISTRY_WINDOWS_NT | La ruta de acceso es relativa a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion. |
| RTL_REGISTRY_DEVICEMAP | La ruta de acceso es relativa a \Registry\Machine\Hardware\DeviceMap. |
| RTL_REGISTRY_USER | La ruta de acceso es relativa a \Registry\User\CurrentUser. (Para un proceso del sistema, es \Users\. Valor predeterminado). |
| RTL_REGISTRY_OPTIONAL | Especifica que la clave a la que hace referencia este parámetro y el parámetro Path son opcionales. |
| RTL_REGISTRY_HANDLE | Especifica que el parámetro Path es realmente un identificador del Registro que se va a usar. Este valor es opcional. |
[in] Path
Puntero a una ruta de acceso absoluta del Registro o a una ruta de acceso relativa a la ubicación conocida especificada por el parámetro RelativeTo . Si se especifica la marca RTL_REGISTRY_HANDLE, este parámetro es un identificador del Registro para que se use directamente una clave ya abierta.
[in] ValueName
Puntero al nombre de una subclave o entrada de valor que se va a escribir en el Registro.
[in] ValueType
Especifica un valor REG_XXX que determina el tipo del parámetro ValueName . Para obtener una lista de los valores posibles, vea el parámetro Type de ZwSetValueKey.
[in, optional] ValueData
Puntero al nombre de una subclave o valores para sus entradas de valor (o ambas) que se van a escribir en el Registro.
[in] ValueLength
Especifica el número de bytes de ValueData que se van a escribir en el Registro.
Valor devuelto
RtlWriteRegistryValue devuelve el estado de la operación, ya sea STATUS_SUCCESS o un estado de error.
Comentarios
Si la clave especificada no existe, la rutina intenta crear la clave. Para que este intento se realice correctamente, la nueva clave debe ser una subclave directa de la clave a la que hace referencia el parámetro Path y la clave a la que hace referencia Path debe haberse abierto para KEY_CREATE_SUB_KEY acceso.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |