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) |