通过

IDebugEventCallbacksWide：：ChangeSymbolState 方法 （dbgeng.h）

  • 项目

当符号状态发生更改时，引擎将调用 ChangeSymbolState 回调方法。

语法

HRESULT ChangeSymbolState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

参数

[in] Flags

指定一个位集，指示更改符号状态的性质。 可以设置以下位标志。

价值 描述
DEBUG_CSS_LOADS 引擎已加载某些模块符号。
DEBUG_CSS_UNLOADS 引擎已卸载一些模块符号。
DEBUG_CSS_SCOPE 当前符号范围已更改。
DEBUG_CSS_PATHS 可执行图像、源或符号搜索路径已更改。
DEBUG_CSS_SYMBOL_OPTIONS 符号选项已更改。
DEBUG_CSS_TYPE_OPTIONS 类型选项已更改。

[in] Argument

提供有关对符号状态的更改的其他信息。 如果在 Flags 参数中设置了多个位标志，则不使用 Argument 参数。 否则，参数 的值取决于 标志的值：

DEBUG_CSS_LOADS

参数 的值是引擎加载符号的模块映像的基本位置（在目标内存地址空间中）。

DEBUG_CSS_UNLOADS

参数 的值是引擎卸载的模块映像的基位置（在目标内存地址空间中）。 如果引擎卸载了多个图像的符号，则 参数 的值为零。

DEBUG_CSS_SCOPE

参数 的值为零。

DEBUG_CSS_PATHS

参数 的值为零。

DEBUG_CSS_SYMBOL_OPTIONS

参数 的值是符号选项。

DEBUG_CSS_TYPE_OPTIONS

参数 的值为零。

返回值

引擎忽略返回值，除非它指示远程过程调用错误;在这种情况下，将禁用此 IDebugEventCallbacksWide 对象的客户端。

言论

仅当 IDebugEventCallbacksWide：：GetInterestMask返回的掩码中设置DEBUG_EVENT_CHANGE_SYMBOL_STATE标志时，引擎才会调用此方法。

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

要求

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