REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION 構造体は、キーに対して取得される複数の値エントリを記述します。
構文
typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
PVOID Object;
PKEY_VALUE_ENTRY ValueEntries;
ULONG EntryCount;
PVOID ValueBuffer;
PULONG BufferLength;
PULONG RequiredBufferLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;
メンバーズ
Object
値エントリを取得するキーのレジストリ キー オブジェクトへのポインター。
ValueEntries
取得される値エントリごとに 1 つずつ、KEY_VALUE_ENTRY 構造体の配列へのポインター。
EntryCount
ValueEntries 配列内のエントリの数。
ValueBuffer
ValueEntries 配列で指定されたすべての値エントリのデータを (システムから) 受信するバッファーへのポインター。
BufferLength
ValueBuffer バッファーの長さをバイト単位で格納している変数へのポインター。
RequiredBufferLength
ValueEntries 配列が指定するすべての値エントリのデータを保持するために必要なバイト数を (システムから) 受け取る変数へのポインター。 このメンバーは NULL できます。
CallContext
ドライバーの RegistryCallback ルーチンが提供できるオプションのドライバー定義コンテキスト情報。 このメンバーは、Windows Vista 以降のバージョンの Windows オペレーティング システム用に定義されています。
ObjectContext
cmSetCallbackObjectContext を呼び出すことによって、ドライバーがレジストリ オブジェクトに関連付けたドライバー定義のコンテキスト情報へのポインター。 このメンバーは、Windows Vista 以降のバージョンの Windows オペレーティング システム用に定義されています。
Reserved
このメンバーは、今後使用するために予約されています。 このメンバーは、Windows Vista 以降のバージョンの Windows オペレーティング システム用に定義されています。
備考
システムは、ユーザー モードのスレッドが RegQueryMultipleValues を呼び出す場合など、一度にキーの複数の値エントリを取得しようとするたびに、この構造体を RegistryCallback ルーチンに渡します。
ValueEntries 配列内の各 KEY_VALUE_ENTRY 構造体は、ValueBuffer バッファー内の 1 つの値エントリを記述します。 具体的には、KEY_VALUE_ENTRY の DataOffset メンバーには、その値エントリのデータが開始 ValueBuffer 内のオフセットが含まれており、DataLength メンバーには、その値エントリのデータの長さ (バイト単位) が含まれます。
レジストリ のフィルター処理操作の詳細については、「レジストリ呼び出しのフィルター処理 を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Microsoft Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |