REG_ENUMERATE_KEY_INFORMATION 構造体 (wdm.h)

REG_ENUMERATE_KEY_INFORMATION構造体は、サブキーが列挙されているキーの 1 つのサブキーを記述します。

構文

typedef struct _REG_ENUMERATE_KEY_INFORMATION {
  PVOID                 Object;
  ULONG                 Index;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_ENUMERATE_KEY_INFORMATION, *PREG_ENUMERATE_KEY_INFORMATION;

メンバー

Object

サブキーが列挙されているキーのレジストリ キー オブジェクトへのポインター。

Index

キー内のサブキーの 0 から始まるインデックス。

KeyInformationClass

KeyInformation バッファーでシステムによって返される情報の種類を示すKEY_INFORMATION_CLASS値。

KeyInformation

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

Length

KeyInformation バッファーのサイズ (バイト単位)。

ResultLength

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

CallContext

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

ObjectContext

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

Reserved

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

注釈

この構造体は、ユーザー モードのスレッドが RegEnumKey または RegEnumKeyEx を呼び出したときや、ドライバーが ZwEnumerateKey を呼び出すときなど、スレッドがキーのサブキーを列挙しようとするたびに、この構造体を RegistryCallback ルーチンに渡します。

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

要件

こちらもご覧ください

CmSetCallbackObjectContext

KEY_INFORMATION_CLASS

RegistryCallback

ZwEnumerateKey