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 オペレーティング システムで使用できます。
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

こちらもご覧ください

CmSetCallbackObjectContext

RegistryCallback

ZwQueryKey