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 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 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 del búfer ValueData necesario para contener la información de datos.

Valor devuelto

Devuelve STATUS_SUCCESS si se ejecuta correctamente o el código de error adecuado en caso de error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1809
Encabezado ntddk.h (include wdm.h)
Library NtosKrnl.lib
IRQL PASSIVE_LEVEL

Consulte también

Uso del Registro en un controlador