estructura KEY_FULL_INFORMATION (wdm.h)

Artículo
02/27/2024

La estructura KEY_FULL_INFORMATION define la información disponible para una clave del Registro, incluida la información sobre sus subclaves y la longitud máxima de sus nombres y entradas de valor. Esta información se puede usar para ajustar el tamaño de los búferes para obtener los nombres de las subclaves y sus entradas de valor.

Sintaxis

typedef struct _KEY_FULL_INFORMATION {
  LARGE_INTEGER LastWriteTime;
  ULONG         TitleIndex;
  ULONG         ClassOffset;
  ULONG         ClassLength;
  ULONG         SubKeys;
  ULONG         MaxNameLen;
  ULONG         MaxClassLen;
  ULONG         Values;
  ULONG         MaxValueNameLen;
  ULONG         MaxValueDataLen;
  WCHAR         Class[1];
} KEY_FULL_INFORMATION, *PKEY_FULL_INFORMATION;

Miembros

LastWriteTime

La última vez que esta clave o cualquiera de sus valores cambiaron. Este valor de hora se expresa en formato de hora absoluto del sistema. La hora absoluta del sistema es el número de intervalos de 100 nanosegundos desde el inicio del año 1601 en el calendario gregoriano.

TitleIndex

Los controladores intermedios y de dispositivo deben omitir este miembro.

ClassOffset

Desplazamiento de bytes desde el principio de esta estructura al miembro Class .

ClassLength

Tamaño, en bytes, de la cadena de nombre de clase de clave en la matriz Class .

SubKeys

Número de subclaves de esta clave.

MaxNameLen

Tamaño máximo, en bytes, de cualquier nombre para una subclave.

MaxClassLen

Tamaño máximo, en bytes, de un nombre de clase.

Values

Número de entradas de valor para esta clave.

MaxValueNameLen

Tamaño máximo, en bytes, de un nombre de entrada de valor.

MaxValueDataLen

Tamaño máximo, en bytes, de un campo de datos de entrada de valor.

Class[1]

Matriz de caracteres anchos que contiene el nombre de la clase de la clave. Esta cadena de caracteres no está terminada en null. Solo el primer elemento de esta matriz se incluye en la definición de estructura de KEY_FULL_INFORMATION . El almacenamiento de los elementos restantes de la matriz sigue inmediatamente a este elemento.

Comentarios

Las rutinas ZwEnumerateKey y ZwQueryKey usan la estructura KEY_FULL_INFORMATION para contener la información completa de una clave del Registro. Cuando el parámetro KeyInformationClass de cualquiera de las rutinas es KeyFullInformation, el búfer KeyInformation se trata como una estructura de KEY_FULL_INFORMATION . Para obtener más información sobre el valor de enumeración KeyFullInformation , consulte KEY_INFORMATION_CLASS.