通过

IDebugEventCallbacks：：LoadModule 方法 （dbgeng.h）

  • 项目

当模块加载调试事件发生在目标中时，引擎将调用 LoadModule 回调方法。

语法

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

参数

[in] ImageFileHandle

指定模块映像文件的句柄。 如果此信息不可用，ImageFileHandle 将 NULL。

[in] BaseOffset

指定目标内存地址空间中模块的基址。 如果此信息不可用，BaseOffset 将 NULL。

[in] ModuleSize

指定模块的图像大小（以字节为单位）。 如果此信息不可用，ModuleSize 将 NULL。

[in, optional] ModuleName

指定调试器引擎使用的简化模块名称。 在大多数情况下，这与不包括扩展名的图像文件名匹配。 如果此信息不可用，ModuleName 将 NULL。

[in, optional] ImageName

指定模块的图像文件名，其中包含路径。 如果此信息不可用，ImageName 将 NULL。

[in] CheckSum

指定模块映像文件的校验和。 如果此信息不可用，CheckSum 将 NULL。

[in] TimeDateStamp

指定模块映像文件的日期和时间戳。 如果此信息不可用，TimeDateStamp 将为零。

返回值

此方法返回一个 DEBUG_STATUS_XXX 值，该值指示引擎处理此事件后目标的执行应如何继续。 有关引擎如何处理此值的详细信息，请参阅 监视事件。

言论

只有在 IDebugEventCallbacks：：GetInterestMask返回的掩码中设置了DEBUG_EVENT_LOAD_MODULE标志时，引擎才会调用此方法。

调用此方法后，引擎将调用 IDebugEventCallbacks：：ChangeSymbolState，Flags 参数，其中包含位标志DEBUG_CSS_LOADS。

有关处理事件的详细信息，请参阅 监视事件。

要求

要求 价值
目标平台 桌面
标头 dbgeng.h （包括 Dbgeng.h）