IDebugSymbols3::SetScopeFrameByIndex メソッド (dbgeng.h)

[アーティクル]
02/26/2024

SetScopeFrameByIndex メソッドは、現在のスコープを呼び出し履歴上のフレームの 1 つのスコープに設定します。

構文

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

パラメーター

[in] Index

スコープを設定するスタックフレームのインデックスを指定します。インデックスは、呼び出し履歴の先頭からのフレーム数をカウントします。現在の呼び出しを表すスタックの上部にあるフレームには、インデックス 0 があります。

戻り値

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

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

注釈

イベントが発生し、デバッガーエンジンがターゲットに分割されると、スコープは現在の関数呼び出し (イベントが発生したときに実行されていた関数) に設定されます。 Index を 1 に設定してこのメソッドを呼び出すと、現在のスコープが現在の関数の呼び出し元に変更されます。Index を 2 に設定すると、スコープは呼び出し元の呼び出し元に変更されます。

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