structure KEY_FULL_INFORMATION (wdm.h)

Article
02/27/2024

La structure KEY_FULL_INFORMATION définit les informations disponibles pour une clé de Registre, notamment des informations sur ses sous-clés et la longueur maximale de leurs noms et entrées de valeur. Ces informations peuvent être utilisées pour dimensionner les mémoires tampons afin d’obtenir les noms des sous-clés et leurs entrées de valeur.

Syntaxe

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;

Membres

LastWriteTime

Dernière modification de cette clé ou de l’une de ses valeurs. Cette valeur de temps est exprimée dans le format d’heure système absolu. Le temps système absolu est le nombre d’intervalles de 100 nanosecondes depuis le début de l’année 1601 dans le calendrier grégorien.

TitleIndex

Les pilotes d’appareil et intermédiaires doivent ignorer ce membre.

ClassOffset

Décalage d’octet entre le début de cette structure et le membre Class .

ClassLength

Taille, en octets, de la chaîne de nom de classe de clé dans le tableau Class .

SubKeys

Nombre de sous-clés pour cette clé.

MaxNameLen

Taille maximale, en octets, de n’importe quel nom pour une sous-clé.

MaxClassLen

Taille maximale, en octets, d’un nom de classe.

Values

Nombre d’entrées de valeur pour cette clé.

MaxValueNameLen

Taille maximale, en octets, d’un nom d’entrée de valeur.

MaxValueDataLen

Taille maximale, en octets, d’un champ de données d’entrée de valeur.

Class[1]

Tableau de caractères larges qui contient le nom de la classe de la clé. Cette chaîne de caractères n’est pas terminée par null. Seul le premier élément de ce tableau est inclus dans la définition de structure KEY_FULL_INFORMATION . Le stockage des éléments restants dans le tableau suit immédiatement cet élément.

Remarques

Les routines ZwEnumerateKey et ZwQueryKey utilisent la structure KEY_FULL_INFORMATION pour contenir les informations complètes d’une clé de Registre. Lorsque le paramètre KeyInformationClass de l’une ou l’autre routine est KeyFullInformation, la mémoire tampon KeyInformation est traitée comme une structure KEY_FULL_INFORMATION . Pour plus d’informations sur la valeur d’énumération KeyFullInformation , consultez KEY_INFORMATION_CLASS.