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 オペレーティング システム用に定義されています。

注釈

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

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

要件

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

こちらもご覧ください

CmSetCallbackObjectContext

RegistryCallback

ZwDeleteKey

ZwQueryValueKey