KEY_FULL_INFORMATION結構 (wdm.h)

發行項
02/27/2024

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

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

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。