estructura de REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION (wdm.h)

La estructura REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION describe las varias entradas de valor que se recuperan para una clave.

Sintaxis

typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
  PVOID            Object;
  PKEY_VALUE_ENTRY ValueEntries;
  ULONG            EntryCount;
  PVOID            ValueBuffer;
  PULONG           BufferLength;
  PULONG           RequiredBufferLength;
  PVOID            CallContext;
  PVOID            ObjectContext;
  PVOID            Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;

Miembros

Object

Puntero al objeto de clave del Registro para la clave cuyas entradas de valor se están recuperando.

ValueEntries

Puntero a una matriz de estructuras de KEY_VALUE_ENTRY , una para cada entrada de valor que se recupera.

EntryCount

Número de entradas de la matriz ValueEntries .

ValueBuffer

Puntero a un búfer que recibe (del sistema) los datos de todas las entradas de valor especificadas por la matriz ValueEntries .

BufferLength

Puntero a una variable que contiene la longitud, en bytes, del búfer ValueBuffer .

RequiredBufferLength

Puntero a una variable que recibe (del sistema) el número de bytes necesarios para contener los datos de todas las entradas de valor que especifica la matriz ValueEntries . Este miembro puede ser NULL.

CallContext

Información de contexto opcional definida por el controlador que puede proporcionar la rutina RegistryCallback del controlador. Este miembro se define para Windows Vista y versiones posteriores del sistema operativo Windows.

ObjectContext

Puntero a la información de contexto definida por el controlador que el controlador ha asociado a un objeto del Registro llamando a CmSetCallbackObjectContext. Este miembro se define para Windows Vista y versiones posteriores del sistema operativo Windows.

Reserved

Este miembro se reserva para uso futuro. Este miembro se define para Windows Vista y versiones posteriores del sistema operativo Windows.

Comentarios

El sistema pasa esta estructura a la rutina RegistryCallback cada vez que un subproceso intenta recuperar varias entradas de valor para una clave a la vez, por ejemplo, cuando un subproceso en modo de usuario llama a RegQueryMultipleValues.

Cada KEY_VALUE_ENTRY estructura de la matriz ValueEntries describe una entrada de valor en el búfer ValueBuffer . En concreto, el miembro DataOffset de KEY_VALUE_ENTRY contiene el desplazamiento dentro de ValueBuffer donde comienzan los datos de esa entrada de valor y el miembro DataLength contiene la longitud, en bytes, de los datos de esa entrada de valor.

Para obtener más información sobre las operaciones de filtrado del registro, consulte Filtrado de llamadas del Registro.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y versiones posteriores del sistema operativo Windows.
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback