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)

另請參閱

CmSetCallbackObjectContext

RegistryCallback

ZwDeleteKey

ZwQueryValueKey