KEY_VALUE_BASIC_INFORMATION Struktur (wdm.h)

Artikel
10/17/2024

Die KEY_VALUE_BASIC_INFORMATION-Struktur definiert eine Teilmenge der vollständigen Informationen, die für einen Werteintrag eines Registrierungsschlüssels verfügbar sind.

Syntax

typedef struct _KEY_VALUE_BASIC_INFORMATION {
  ULONG TitleIndex;
  ULONG Type;
  ULONG NameLength;
  WCHAR Name[1];
} KEY_VALUE_BASIC_INFORMATION, *PKEY_VALUE_BASIC_INFORMATION;

Angehörige

TitleIndex

Geräte- und Zwischentreiber sollten dieses Element ignorieren.

Type

Gibt den vom System definierten Typ für den Werteintrag im Registrierungsschlüssel an. Dies ist eine der folgenden:

REG_XXX- Typ	Wert
REG_BINARY	Binärdaten in beliebiger Form
REG_DWORD	Ein numerischer 4-Byte-Wert
REG_DWORD_LITTLE_ENDIAN	Ein numerischer 4-Byte-Wert, dessen am wenigsten signifikantes Byte an der niedrigsten Adresse liegt
REG_DWORD_BIG_ENDIAN	Ein numerischer 4-Byte-Wert, dessen am wenigsten signifikantes Byte die höchste Adresse ist
REG_EXPAND_SZ	Eine mit Null beendete Unicode-Zeichenfolge mit nicht erweiterten Verweisen auf Umgebungsvariablen, z. B. "%PATH%"
REG_LINK	Eine Unicode-Zeichenfolge, die eine symbolische Verknüpfung benennt. Dieser Typ ist für Geräte- und Zwischentreiber irrelevant.
REG_MULTI_SZ	Ein Array von null-beendeten Zeichenfolgen, die durch eine andere Null beendet werden
REG_NONE	Daten ohne bestimmten Typ
REG_SZ	Eine mit Null beendete Unicode-Zeichenfolge
REG_RESOURCE_LIST	Eine Gerätetreiberliste mit Hardwareressourcen, die vom Treiber oder einem der von ihr gesteuerten physischen Geräte verwendet werden, in der struktur \ResourceMap
REG_RESOURCE_REQUIREMENTS_LIST	Die Liste der möglichen Hardwareressourcen eines Gerätetreibers oder eines der von ihr gesteuerten physischen Geräte, aus denen das System eine Teilmenge in die \ResourceMap Struktur schreibt
REG_FULL_RESOURCE_DESCRIPTOR	Eine Liste der Hardwareressourcen, die ein physisches Gerät verwendet, erkannt und in die \HardwareDescription- Struktur des Systems geschrieben wird
REG_QWORD	Ein numerischer 8-Byte-Wert
REG_QWORD_LITTLE_ENDIAN	Ein numerischer 8-Byte-Wert, dessen kleinstes Byte an der niedrigsten Adresse liegt

NameLength

Gibt die Größe in Byte des folgenden Werteintragsnamens an.

Name[1]

Eine Zeichenfolge von Unicode-Zeichen, die einen Werteintrag des Schlüssels benennen.

Bemerkungen

Ein Kernelmodustreiber kann einen KEY_VALUE_BASIC_INFORMATION abrufen, der einen Registrierungsschlüssel beschreibt, indem er die ZwQueryValueKey oder ZwEnumerateValueKey Routine aufruft.