IDebugSymbols3::GetScopeSymbolGroup2 方法 (dbgeng.h)
GetScopeSymbolGroup2 方法返回一个符号组,其中包含当前目标范围内的符号。
语法
HRESULT GetScopeSymbolGroup2(
[in] ULONG Flags,
[in, optional] PDEBUG_SYMBOL_GROUP2 Update,
[out] PDEBUG_SYMBOL_GROUP2 *Symbols
);
参数
[in] Flags
指定用于确定要包含在符号组中的符号的位集。 若要包含所有符号,请将 “标志” 设置为“DEBUG_SCOPE_GROUP_ALL”。 以下位标志确定包含哪些符号。
标志 | 描述 |
---|---|
DEBUG_SCOPE_GROUP_ARGUMENTS | 包括当前范围的函数参数。 |
DEBUG_SCOPE_GROUP_LOCALS | 包括当前范围的局部变量。 |
[in, optional] Update
指定之前创建的符号组,该符号组将更新以反映当前范围。 如果 Update 为 NULL,则会创建一个新的符号组接口对象。
[out] Symbols
接收当前范围的符号组接口对象。 有关此接口的详细信息,请参阅 IDebugSymbolGroup
返回值
此方法也可能返回错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
注解
Update 参数允许在单步执行代码时进行高效更新。 可以更新旧符号组,而不是创建和填充新的符号组。
有关范围和符号组的详细信息,请参阅 范围和符号组。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |