REG_QUERY_VALUE_KEY_INFORMATION結構 (wdm.h)
REG_QUERY_VALUE_KEY_INFORMATION 結構包含正在查詢之登錄機碼值專案的相關信息。
語法
typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
PVOID Object;
PUNICODE_STRING ValueName;
KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
PVOID KeyValueInformation;
ULONG Length;
PULONG ResultLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;
成員
Object
正在查詢其值專案之機碼的登錄機碼物件的指標。
ValueName
UNICODE_STRING 結構的指標，其中包含要擷取資訊之值項目的名稱。
KeyValueInformationClass
KEY_VALUE_INFORMATION_CLASS值，指出系統要傳回的信息類型。
KeyValueInformation
緩衝區的指標，其中包含系統要傳回的資訊。 緩衝區的格式取決於 KeyValueInformationClass 的值。 如需詳細資訊，請參閱 KEY_VALUE_INFORMATION_CLASS。
Length
KeyValueInformation 緩衝區的大小，以位元組為單位。
ResultLength
從系統接收 (的變數指標，) KeyValueInformation 緩衝區中的有效數據量，以位元組為單位。
CallContext
驅動程式的 RegistryCallback 例程可以提供的選擇性驅動程式定義內容資訊。 這個成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。
ObjectContext
驅動程式定義內容資訊的指標，驅動程式藉由呼叫 CmSetCallbackObjectContext 與登錄對象相關聯。 這個成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。
Reserved
這個成員保留供未來使用。 這個成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。
備註
每當線程嘗試查詢機碼的值專案時，系統會將此結構傳遞至 RegistryCallback 例程，例如，當使用者模式線程呼叫 RegQueryValue 或 RegQueryValueEx 或驅動程式呼叫 ZwDeleteKey 時。
如需登錄篩選作業的詳細資訊，請參閱 篩選登錄呼叫。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows XP 和更新版本的 Windows 作業系統上使用。 |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |