structure KEY_FULL_INFORMATION (wdm.h)
La structure KEY_FULL_INFORMATION définit les informations disponibles pour une clé de Registre, y compris les informations relatives à 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 pour 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
La dernière fois que cette clé ou l’une de ses valeurs ont changé. Cette valeur de temps est exprimée au format de temps système absolu. L’heure système absolue 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 de périphérique et intermédiaire doivent ignorer ce membre.
ClassOffset
Décalage d’octet entre le début de cette structure et le membre classe.
ClassLength
Taille, en octets, de la chaîne de nom de classe de clé dans le tableau classe.
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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |