REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION結構 (wdm.h)
REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION 結構包含驅動程式的 RegistryCallback 例程可用來釋放驅動程式先前為與登錄物件相關聯之內容配置的資源。
語法
typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
PVOID Object;
PVOID ObjectContext;
PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;
成員
Object
要刪除之機碼的登錄機碼物件的指標。
ObjectContext
驅動程式定義內容資訊的指標,驅動程式藉由呼叫 CmSetCallbackObjectContext 與登錄對象相關聯。
Reserved
這個成員保留供未來使用。
備註
RegistryCallback 例程會使用此結構。 當 RegistryCallback 例程的 Argument1 參數是 RegNtCallbackObjectContextCleanup 時,Argument2 參數是REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION 結構的指標。
驅動程式的 RegistryCallback 例程會在索引鍵對象的參考計數捨棄為零 (時收到 RegNtCallbackObjectContextCleanup 通知,也就是沒有未完成的句柄或索引鍵物件的指標參考) 。
為了回應此通知,例程應該釋放配置給對象內容的任何資源。 當驅動程式呼叫 CmUnRegisterCallback 或驅動程式的 RegistryCallback 例程剛完成處理 RegNtPreKeyHandleClose 通知時,就會發生 RegNtCallbackObjectContextCleanup 通知。
如需登錄篩選作業的詳細資訊,請參閱 篩選登錄呼叫。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows Vista 開始提供。 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |