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 参数。 否则， Argument 的值取决于 Flags 的值：

DEBUG_CSS_LOADS

Argument 的值是目标内存地址空间 (引擎为其加载符号的模块映像) 的基本位置。

DEBUG_CSS_UNLOADS

Argument 的值是目标内存地址空间) 引擎为其卸载符号的模块映像的基位置 (。 如果引擎卸载了多个图像的符号， 则 Argument 的值为零。

DEBUG_CSS_SCOPE

Argument 的值为零。

DEBUG_CSS_PATHS

Argument 的值为零。

DEBUG_CSS_SYMBOL_OPTIONS

Argument 的值是符号选项。

DEBUG_CSS_TYPE_OPTIONS

Argument 的值为零。

返回值

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

注解

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

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

要求

要求 值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)