struttura KEY_FULL_INFORMATION (wdm.h)

Articolo
03/08/2023

La struttura KEY_FULL_INFORMATION definisce le informazioni disponibili per una chiave del Registro di sistema, incluse le informazioni sulle relative sottochiavi e la lunghezza massima per i nomi e le voci di valore. Queste informazioni possono essere usate per ridimensionare i buffer per ottenere i nomi delle sottochiavi e le relative voci di valore.

Sintassi

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;

Members

LastWriteTime

Ora dell'ultima modifica di questa chiave o di uno dei relativi valori. Questo valore di ora è espresso in formato ora di sistema assoluto. L'ora di sistema assoluta è il numero di intervalli di 100 nanosecondi dall'inizio dell'anno 1601 nel calendario gregoriano.

TitleIndex

I driver intermedi e del dispositivo devono ignorare questo membro.

ClassOffset

Offset di byte dall'inizio di questa struttura al membro Class .

ClassLength

Dimensione, in byte, della stringa del nome della classe chiave nella matrice Class .

SubKeys

Numero di sottochiavi per questa chiave.

MaxNameLen

Dimensione massima, in byte, di qualsiasi nome per una sottochiave.

MaxClassLen

Dimensione massima, in byte, di un nome di classe.

Values

Numero di voci di valore per questa chiave.

MaxValueNameLen

Dimensione massima, in byte, di un nome di voce di valore.

MaxValueDataLen

Dimensione massima, in byte, di un campo dati di immissione valore.

Class[1]

Matrice di caratteri wide che contiene il nome della classe della chiave. Questa stringa di caratteri non è con terminazione Null. Nella definizione della struttura KEY_FULL_INFORMATION è incluso solo il primo elemento in questa matrice. Lo spazio di archiviazione per gli elementi rimanenti nella matrice segue immediatamente questo elemento.

Commenti

Le routine ZwEnumerateKey e ZwQueryKey usano la struttura KEY_FULL_INFORMATION per contenere le informazioni complete per una chiave del Registro di sistema. Quando il parametro KeyInformationClass di una delle due routine è KeyFullInformation, il buffer KeyInformation viene considerato come una struttura KEY_FULL_INFORMATION . Per altre informazioni sul valore dell'enumerazione KeyFullInformation , vedi KEY_INFORMATION_CLASS.