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
現在のスコープを反映するように更新する、以前に作成したシンボル グループを指定します。 Update が NULL の場合は、新しいシンボル グループ インターフェイス オブジェクトが作成されます。
[out] Symbols
現在のスコープのシンボル グループ インターフェイス オブジェクトを受け取ります。 このインターフェイスの詳細については、「IDebugSymbolGroup」を参照してください。
戻り値
このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
注釈
Update パラメーターを使用すると、コードをステップ実行するときに効率的に更新できます。 新しいシンボル グループを作成して設定する代わりに、古いシンボル グループを更新できます。
スコープとシンボル グループの詳細については、「 スコープとシンボル グループ」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | dbgeng.h (Dbgeng.h を含む) |