IDebugEventCallbacks::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 的值为零。

返回值

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

注解

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

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

要求

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