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」を参照してください。

戻り値

このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。

リターン コード 説明
S_OK
 メソッドは正常に実行されました。

注釈

Update パラメーターを使用すると、コードをステップ実行するときに効率的に更新できます。 新しいシンボル グループを作成して設定する代わりに、古いシンボル グループを更新できます。

スコープとシンボル グループの詳細については、「 スコープとシンボル グループ」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)

こちらもご覧ください

GetScope

IDebugSymbolGroup

IDebugSymbols

IDebugSymbols2

IDebugSymbols3