IDebugSymbols3::GetScopeSymbolGroup 方法 (dbgeng.h)

GetScopeSymbolGroup 方法返回一个符号组,其中包含当前目标作用域中的符号。

语法

HRESULT GetScopeSymbolGroup(
  [in]           ULONG               Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP Update,
  [out]          PDEBUG_SYMBOL_GROUP *Symbols
);

参数

[in] Flags

指定用于确定要包含在符号组中的符号的位集。 若要包括所有符号,请将 标志 设置为DEBUG_SCOPE_GROUP_ALL。 以下位标志确定包括哪些符号。

描述
DEBUG_SCOPE_GROUP_ARGUMENTS 包括当前范围的函数参数。
DEBUG_SCOPE_GROUP_LOCALS 包括当前范围的局部变量。

[in, optional] Update

指定之前创建的符号组,该组将更新以反映当前范围。 如果 更新NULL,则会创建新的符号组接口对象。

[out] Symbols

接收当前范围的符号组接口对象。 有关此接口的详细信息,请参阅 IDebugSymbolGroup

返回值

此方法也可能返回错误值。 有关详细信息,请参阅 返回值

返回代码 描述
S_OK
该方法成功。

言论

Update 参数允许在单步执行代码时高效更新。 可以更新旧符号组,而不是创建和填充新符号组。

有关范围和符号组的详细信息,请参阅 范围和符号组

要求

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

另请参阅

GetScope

IDebugSymbolGroup

IDebugSymbols

IDebugSymbols2

IDebugSymbols3