estructura REG_QUERY_KEY_INFORMATION (wdm.h)

  • Artículo

La estructura REG_QUERY_KEY_INFORMATION describe los metadatos que están a punto de consultarse para una clave.

Sintaxis

typedef struct _REG_QUERY_KEY_INFORMATION {
  PVOID                 Object;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;

Miembros

Object

Puntero al objeto de clave del Registro para la clave cuyos metadatos están a punto de consultarse.

KeyInformationClass

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

KeyInformation

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 KeyInformationClass. Para obtener más información, consulte KEY_INFORMATION_CLASS.

Length

Especifica el tamaño, en bytes, del búfer KeyInformation .

ResultLength

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

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 la rutina RegistryCallback cada vez que un subproceso intenta consultar los metadatos de una clave, por ejemplo, cuando un subproceso en modo de usuario llama a RegQueryInfoKey o cuando un controlador llama a ZwQueryKey.

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

ZwQueryKey