Compartir a través de


estructura REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION (wdm.h)

La estructura REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION describe las entradas de varios valores 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 el ValueEntries matriz.

BufferLength

Puntero a una variable que contiene la longitud, en bytes, del búfer de 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 el ValueEntries matriz. Este miembro puede ser NULL.

CallContext

Información de contexto opcional definida por el controlador que puede proporcionar la rutina registryCall back del controlador RegistryCallback. 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 está reservado para uso futuro. Este miembro se define para Windows Vista y versiones posteriores del sistema operativo Windows.

Observaciones

El sistema pasa esta estructura a la rutina de 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 estructura KEY_VALUE_ENTRY de la matriz de ValueEntries describe una entrada de valor en el búfer de ValueBuffer de. 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 Valor
cliente mínimo admitido Disponible en Microsoft Windows XP y versiones posteriores del sistema operativo Windows.
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

registryCallback