REG_UNLOAD_KEY_INFORMATION 結構 (wdm.h)

REG_UNLOAD_KEY_INFORMATION 結構包含驅動程式的 RegistryCallback 例程在卸載登錄區時可以使用的資訊。

語法

typedef struct _REG_UNLOAD_KEY_INFORMATION {
  PVOID Object;
  PVOID UserEvent;
  PVOID CallContext;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_UNLOAD_KEY_INFORMATION, *PREG_UNLOAD_KEY_INFORMATION;

成員

Object

登錄機碼物件的指標。 此物件代表正在卸除之Hive的根索引鍵。

UserEvent

事件物件的指標。

CallContext

驅動程式的 RegistryCallback 例程可以提供的選擇性驅動程式定義內容資訊。 這個成員是從 Windows Vista 開始定義的。

ObjectContext

驅動程式定義內容資訊的指標，驅動程式藉由呼叫 CmSetCallbackObjectContext 與登錄對象相關聯。 這個成員是從 Windows Vista 開始定義的。

Reserved

這個成員保留供未來使用。 這個成員是從 Windows Vista 開始定義的。

備註

RegistryCallback 例程會使用此結構。 當 RegistryCallback 例程的 Argument1 參數是 RegNtPreUnloadKey 時，Argument2 參數是REG_UNLOAD_KEY_INFORMATION結構的指標。

每當線程嘗試卸除機碼時，操作系統會將 REG_UNLOAD_KEY_INFORMATION 結構傳遞至 RegistryCallback 例程，例如，當使用者模式線程呼叫 RegUnloadKey 函 式時。 為了回應 RegNtPreUnloadKey 通知， RegistryCallback 例程應該釋放驅動程式先前配置來與 Hive 搭配使用的任何資源，然後再卸除 Hive。

如需登錄篩選作業的詳細資訊，請參閱 篩選登錄呼叫。

規格需求

需求	值
最低支援的用戶端	從 Windows Vista 開始提供。
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

CmSetCallbackObjectContext

RegistryCallback