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