Método IRegistryKey::QueryRegistryValues (portcls.h)

El QueryRegistryValues método permite al autor de la llamada consultar varios valores del Registro con una sola llamada.

Sintaxis

NTSTATUS QueryRegistryValues(
  [in]           PRTL_QUERY_REGISTRY_TABLE QueryTable,
  [in, optional] PVOID                     Context
);

Parámetros

[in] QueryTable

Puntero a una matriz de una o varias estructuras de RTL_QUERY_REGISTRY_TABLE. (Esta estructura se describe en RtlQueryRegistryValues). Cada estructura especifica el nombre del valor y el nombre de la subclave de una entrada del Registro que el autor de la llamada está consultando. Cada estructura también contiene un puntero de función a una devolución de llamada de QueryRoutine proporcionada por el autor de la llamada que el QueryRegistryValues método llamará con información sobre la entrada del Registro correspondiente. La matriz debe terminarse mediante una estructura con un miembro Name que sea NULL.

[in, optional] Context

Se trata de un valor de contexto definido por el autor de la llamada. El QueryRegistryValues método pasa este valor como parámetro de llamada a cada una de las devoluciones de llamada de QueryRoutine . El valor de contexto suele ser un puntero a una estructura definida por el autor de la llamada que contiene datos de contexto a los que accede queryRoutine del autor de la llamada. El valor de contexto se convierte al tipo de puntero PVOID, pero el QueryRegistryValues método no realiza ninguna validación del puntero.

Valor devuelto

QueryRegistryValues devuelve STATUS_SUCCESS si la llamada se realizó correctamente al procesar toda la QueryTable. De lo contrario, el método devuelve un código de error adecuado. En la tabla siguiente se muestran algunos de los posibles códigos de estado de retorno.

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	Indica que el parámetro QueryTable que se pasó al método no es válido.
STATUS_OBJECT_NAME_NOT_FOUND	Indica que el método no pudo encontrar el objeto especificado en una de las entradas queryTable .

Comentarios

Este método usa rutinas de devolución de llamada proporcionadas por el autor de la llamada para enumerar los valores de una lista de entradas del Registro. Si se ejecuta correctamente, el método devuelve después de llamar a todas las rutinas de devolución de llamada de la lista.

El parámetro QueryTable apunta a una matriz de estructuras de RTL_QUERY_REGISTRY_TABLE. El primer miembro de esta estructura, QueryRoutine, es un puntero de función a una rutina de devolución de llamada proporcionada por el autor de la llamada. Para obtener más información, vea RtlQueryRegistryValues.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	portcls.h (incluya Portcls.h)
IRQL	PASSIVE_LEVEL

Consulte también

IRegistryKey

RtlQueryRegistryValues