REG_RESTORE_KEY_INFORMATION 構造体 (wdm.h)

  • [アーティクル]

REG_RESTORE_KEY_INFORMATION構造体には、復元しようとしているレジストリ キーの情報が含まれています。

構文

typedef struct _REG_RESTORE_KEY_INFORMATION {
  PVOID  Object;
  HANDLE FileHandle;
  ULONG  Flags;
  PVOID  CallContext;
  PVOID  ObjectContext;
  PVOID  Reserved;
} REG_RESTORE_KEY_INFORMATION, *PREG_RESTORE_KEY_INFORMATION;

メンバー

Object

復元されるキーのレジストリ キー オブジェクトへのポインター。

FileHandle

ハイブの復元元となるファイルへのハンドル。

Flags

REG_FORCE_RESTORE

0x00000008L

指定した場合、 hKey パラメーターが指すレジストリ階層内の場所またはその下に開いているハンドルが存在する場合でも、復元操作が実行されます。

REG_WHOLE_HIVE_VOLATILE

0x00000001L

指定した場合、新しい揮発性 (メモリのみ) のレジストリ情報セット ( Hive) が作成されます。 REG_WHOLE_HIVE_VOLATILEが指定されている場合、 hKey パラメーターで識別されるキーは、HKEY_USERSまたはHKEY_LOCAL_MACHINE値である必要があります。

REG_REFRESH_HIVE

0x00000002

設定されている場合、 hKey パラメーターが指すサブツリーの場所は、最後のフラッシュの直後の状態に復元されます。 サブツリーは、(このパラメーターの値として指定されたREG_NO_LAZY_FLUSHを使用して RegRestoreKey を呼び出すことによって) 遅延フラッシュしてはなりません。呼び出し元には、信頼されたコンピューティング ベース (TCB) 特権が必要です。および hKey パラメーターが参照するハンドルは、サブツリーのルートを指している必要があります。

CallContext

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

ObjectContext

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

Reserved

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

注釈

REG_REFRESH_HIVE フラグは不透明であり、フィルターで変更を試みてはいけません。

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

要件

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

こちらもご覧ください

CmSetCallbackObjectContext

RegistryCallback