KEY_FULL_INFORMATION結構（wdm.h）

發行項
02/07/2025

KEY_FULL_INFORMATION 結構會定義登錄機碼可用的資訊，包括其子機碼的相關信息，以及其名稱和值專案的最大長度。此資訊可用來調整緩衝區的大小，以取得子機碼的名稱及其值專案。

語法

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;

成員

LastWriteTime

上次此索引鍵或其任何值變更的時間。這個時間值是以絕對系統時間格式表示。絕對系統時間是公曆 1601 年初以來的 100 奈秒間隔數目。

TitleIndex

裝置和中繼驅動程序應該忽略此成員。

ClassOffset

從這個結構的開頭到 Class 成員的位元組位移。

ClassLength

類別陣列中索引鍵類別名稱字串的大小，以位元組為單位。

SubKeys

此索引鍵的子機碼數目。

MaxNameLen

子機碼之任何名稱的大小上限，以位元組為單位。

MaxClassLen

類別名稱的大小上限，以位元組為單位。

Values

此索引鍵的值項目數目。

MaxValueNameLen

值專案名稱的大小上限，以位元組為單位。

MaxValueDataLen

值輸入數據欄位的大小上限，以位元組為單位。

Class[1]

寬字元陣列，其中包含索引鍵類別的名稱。此字元字串未 null 終止。只有這個陣列中的第一個專案會包含在 KEY_FULL_INFORMATION 結構定義中。陣列中剩餘元素的記憶體緊接在這個項目後面。

言論

ZwEnumerateKey 和 ZwQueryKey 例程會使用 KEY_FULL_INFORMATION 結構來包含登錄機碼的完整資訊。當任一例程的 KeyInformationClass 參數 KeyFullInformation時，會將 KeyInformation 緩衝區視為 KEY_FULL_INFORMATION 結構。如需 KeyFullInformation 列舉值的詳細資訊，請參閱 KEY_INFORMATION_CLASS。