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) |