Función RtlQueryRegistryValueWithFallback (ntddk.h)
Recupera una entrada de valor para una clave del Registro mediante, un identificador principal; si no se encuentra, usa el identificador de reserva.
Sintaxis
NTSYSAPI NTSTATUS RtlQueryRegistryValueWithFallback(
[in] HANDLE PrimaryHandle,
[in] HANDLE FallbackHandle,
[in] PUNICODE_STRING ValueName,
[in] ULONG ValueLength,
[Out] PULONG ValueType,
[out] PVOID ValueData,
[out] PULONG ResultLength
);
Parámetros
[in] PrimaryHandle
Identificador de la clave que se usa primero para consultar las entradas de valor. Este identificador se crea mediante una llamada correcta a ZwCreateKey o ZwOpenKey.
[in] FallbackHandle
Identificador que se va a usar para consultar la clave si no se encuentra el valor mediante el identificador especificado por PrimaryHandle.
[in] ValueName
Puntero a cadena que contiene el nombre del valor para el que se van a recuperar los datos.
[in] ValueLength
Especifica el tamaño, en bytes, de la cadena de ValueName.
[Out] ValueType
Puntero a una variable ULONG que recibe el tipo del valor que se consulta.
[out] ValueData
Puntero a un búfer que recibe los datos de valor.
[out] ResultLength
Puntero a una variable que recibe el tamaño de los datos de valor, en bytes. Si el valor devuelto es STATUS_SUCCESS, indica el número de bytes escritos en el búfer de ValueData. Si la llamada devuelve STATUS_BUFFER_OVERFLOW, indica el número de bytes necesarios. Los autores de llamadas pueden usar ese valor para determinar el tamaño de ValueData búfer necesario para contener la información de datos.
Valor devuelto
Devuelve STATUS_SUCCESS correcto o el código de error adecuado en caso de error.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1809 |
| encabezado de | ntddk.h (include wdm.h) |
| biblioteca de | NtosKrnl.lib |
| irQL | PASSIVE_LEVEL |