(dbgeng.h) IDebugEventCallbacks::UnloadModule 方法
當目標中發生模組卸除偵錯事件時,引擎會呼叫 UnloadModule 回呼方法。
語法
HRESULT UnloadModule(
[in, optional] PCSTR ImageBaseName,
[in] ULONG64 BaseOffset
);
參數
[in, optional] ImageBaseName
指定模組映像檔的名稱,其中包含路徑。 如果此資訊無法使用, ImageBaseName 將會是 NULL。
[in] BaseOffset
指定目標記憶體位址空間中模組的基位址。 如果這項信息無法使用, BaseOffset 會是 NULL。
傳回值
這個方法會傳回 DEBUG_STATUS_XXX 值,這個值表示引擎處理此事件之後,應該如何繼續執行目標。 如需引擎如何處理此值的詳細資訊,請參閱 監視事件。
備註
只有在 IDebugEventCallbacks::GetInterestMask 所傳回的遮罩中設定DEBUG_EVENT_UNLOAD_MODULE旗標時,引擎才會呼叫這個方法。
呼叫此方法之後,引擎會呼叫 IDebugEventCallbacks::ChangeSymbolState,並使用包含位旗標的 Flags 參數DEBUG_CSS_UNLOADS。
如需處理事件的詳細資訊,請參閱 監視事件。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h (包含 Dbgeng.h) |