estructura REG_QUERY_VALUE_KEY_INFORMATION (wdm.h)

La estructura REG_QUERY_VALUE_KEY_INFORMATION contiene información sobre la entrada de valor de una clave del Registro que se está consultando.

Sintaxis

typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  PUNICODE_STRING             ValueName;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;

Miembros

Object

Puntero al objeto de clave del Registro para la clave cuya entrada de valor se está consultando.

ValueName

Puntero a una estructura de UNICODE_STRING que contiene el nombre de la entrada de valor para la que se va a recuperar información.

KeyValueInformationClass

Valor de KEY_VALUE_INFORMATION_CLASS que indica el tipo de información que va a devolver el sistema.

KeyValueInformation

Puntero a un búfer que contiene la información que va a devolver el sistema. El formato del búfer depende del valor de KeyValueInformationClass. Para obtener más información, consulte KEY_VALUE_INFORMATION_CLASS.

Length

Tamaño, en bytes, del búfer KeyValueInformation .

ResultLength

Puntero a una variable que recibe (del sistema) la cantidad de datos válidos, en bytes, en el búfer KeyValueInformation .

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 mediante una llamada 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 una rutina RegistryCallback cada vez que un subproceso intenta consultar una entrada de valor para una clave, por ejemplo, cuando un subproceso en modo de usuario llama a RegQueryValue o RegQueryValueEx o cuando un controlador llama a ZwDeleteKey.

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

RegistryCallback

ZwDeleteKey

ZwQueryValueKey