KEY_FULL_INFORMATION-Struktur (wdm.h)

Artikel
02/27/2024

Die KEY_FULL_INFORMATION-Struktur definiert die für einen Registrierungsschlüssel verfügbaren Informationen, einschließlich Informationen zu seinen Unterschlüsseln und der maximalen Länge ihrer Namen und Werteinträge. Diese Informationen können verwendet werden, um Puffer zu vergrößern, um die Namen von Unterschlüsseln und deren Werteinträge abzurufen.

Syntax

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;

Member

LastWriteTime

Die letzte Änderung dieses Schlüssels oder eines seiner Werte. Dieser Zeitwert wird im absoluten Systemzeitformat ausgedrückt. Die absolute Systemzeit ist die Anzahl der Intervalle von 100 Nanosekunden seit Beginn des Jahres 1601 im gregorianischen Kalender.

TitleIndex

Geräte- und Zwischentreiber sollten diesen Member ignorieren.

ClassOffset

Der Byteoffset vom Anfang dieser Struktur zum Klassenmember .

ClassLength

Die Größe der Schlüsselklassennamenzeichenfolge im Class-Array in Bytes.

SubKeys

Die Anzahl der Unterschlüssel für diesen Schlüssel.

MaxNameLen

Die maximale Größe eines beliebigen Namens für einen Unterschlüssel in Bytes.

MaxClassLen

Die maximale Größe eines Klassennamens in Bytes.

Values

Die Anzahl der Werteinträge für diesen Schlüssel.

MaxValueNameLen

Die maximale Größe eines Werteintragsnamens in Bytes.

MaxValueDataLen

Die maximale Größe eines Werteingabedatenfelds in Bytes.

Class[1]

Ein Array von breiten Zeichen, das den Namen der Klasse des Schlüssels enthält. Diese Zeichenfolge ist nicht NULL-beendet. Nur das erste Element in diesem Array ist in der KEY_FULL_INFORMATION-Strukturdefinition enthalten. Der Speicher für die restlichen Elemente im Array folgt sofort diesem Element.

Hinweise

Die Routinen ZwEnumerateKey und ZwQueryKey verwenden die KEY_FULL_INFORMATION-Struktur , um die vollständigen Informationen für einen Registrierungsschlüssel zu enthalten. Wenn der KeyInformationClass-Parameter beider Routinen KeyFullInformation ist, wird der KeyInformation-Puffer als KEY_FULL_INFORMATION-Struktur behandelt. Weitere Informationen zum KeyFullInformation-Enumerationswert finden Sie unter KEY_INFORMATION_CLASS.