REG_QUERY_KEY_INFORMATION構造体 (wdm.h)

REG_QUERY_KEY_INFORMATION 構造体は、キーのクエリを実行しようとしているメタデータを記述します。

構文

typedef struct _REG_QUERY_KEY_INFORMATION {
  PVOID                 Object;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;

メンバーズ

Object

メタデータのクエリを実行しようとしているキーのレジストリ キー オブジェクトへのポインター。

KeyInformationClass

システムによって返される情報の種類を示す KEY_INFORMATION_CLASS 値。

KeyInformation

システムによって返される情報を格納しているバッファーへのポインター。 バッファーの形式は、keyInformationClass 値によって異なります。 詳細については、KEY_INFORMATION_CLASSを参照してください。

Length

KeyInformation バッファーのサイズをバイト単位で指定します。

ResultLength

KeyInformation バッファー内の有効なデータ量 (バイト単位) をシステムから受け取る変数へのポインター。

CallContext

ドライバーの RegistryCallback ルーチンが提供できるオプションのドライバー定義コンテキスト情報。 このメンバーは、Windows Vista 以降のバージョンの Windows オペレーティング システム用に定義されています。

ObjectContext

cmSetCallbackObjectContext を呼び出すことによって、ドライバーがレジストリ オブジェクトに関連付けたドライバー定義のコンテキスト情報へのポインター。 このメンバーは、Windows Vista 以降のバージョンの Windows オペレーティング システム用に定義されています。

Reserved

このメンバーは、今後使用するために予約されています。 このメンバーは、Windows Vista 以降のバージョンの Windows オペレーティング システム用に定義されています。

備考

システムは、ユーザー モードのスレッドが RegQueryInfoKey を呼び出すときや、ドライバーが ZwQueryKey を呼び出す場合など、スレッドがキーのメタデータのクエリを実行しようとするたびに、RegistryCallback ルーチンにこの構造体渡します。

レジストリ のフィルター処理操作の詳細については、「レジストリ呼び出しのフィルター処理 を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Microsoft Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。
ヘッダー	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

関連項目

CmSetCallbackObjectContext

RegistryCallback

ZwQueryKey