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 を含む) |