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

要從中還原Hive之檔案的句柄。

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 作業系統上使用。
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

CmSetCallbackObjectContext

RegistryCallback