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 (包括 Dbgeng.h)