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
返回值
此方法也可能返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
言论
Update 参数允许在单步执行代码时高效更新。 可以更新旧符号组,而不是创建和填充新符号组。
有关范围和符号组的详细信息,请参阅 范围和符号组。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |