IDebugEventCallbacks::UnloadModule 方法 (dbgeng.h)
當目標中發生模組卸除偵錯事件時,引擎會呼叫 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 (include Dbgeng.h) |