IDebugSymbols2::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

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

[out] Symbols

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

返回值

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

返回代码 说明
S_OK
方法成功。

注解

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

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

要求

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

另请参阅

GetScope

IDebugSymbolGroup

IDebugSymbols

IDebugSymbols2

IDebugSymbols3