REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION 結構 (wdm.h)

  • 發行項

REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION 結構描述針對索引鍵擷取的多個值專案。

語法

typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
  PVOID            Object;
  PKEY_VALUE_ENTRY ValueEntries;
  ULONG            EntryCount;
  PVOID            ValueBuffer;
  PULONG           BufferLength;
  PULONG           RequiredBufferLength;
  PVOID            CallContext;
  PVOID            ObjectContext;
  PVOID            Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;

成員

Object

要擷取其值專案之機碼的登錄機碼物件的指標。

ValueEntries

KEY_VALUE_ENTRY 結構的陣列指標，每個擷取的值專案各一個。

EntryCount

ValueEntries 陣列中的項目數。

ValueBuffer

從系統接收 (的緩衝區指標，) ValueEntries 陣列所指定之所有值項目的數據。

BufferLength

變數的指標，其中包含 ValueBuffer 緩衝區的長度，以位元組為單位。

RequiredBufferLength

從系統接收 (之變數的指標，) 保留 ValueEntries 陣列指定之所有值專案之數據所需的位元組數。 此成員可以是 NULL。

CallContext

驅動程式的 RegistryCallback 例程可以提供的選擇性驅動程式定義內容資訊。 這個成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。

ObjectContext

驅動程式定義內容資訊的指標，驅動程式藉由呼叫 CmSetCallbackObjectContext 與登錄對象相關聯。 這個成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。

Reserved

這個成員保留供未來使用。 這個成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。

備註

每當線程嘗試一次擷取索引鍵的多個值專案時，系統會將此結構傳遞至 RegistryCallback 例程，例如，當使用者模式線程呼叫 RegQueryMultipleValues 時。

ValueEntries 陣列中的每個KEY_VALUE_ENTRY結構都會描述 ValueBuffer 緩衝區中的一個值專案。 具體來說，KEY_VALUE_ENTRY的 DataOffset 成員包含 ValueBuffer 內的位移，其中該值專案的數據開始，而 DataLength 成員包含該值專案之數據的長度，以位元組為單位。

如需登錄篩選作業的詳細資訊，請參閱 篩選登錄呼叫。

規格需求

需求 值
最低支援的用戶端 可在 Microsoft Windows XP 和更新版本的 Windows 作業系統上使用。
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback