ICorDebugThread3::GetActiveInternalFrames メソッド
スタック上の内部フレーム (ICorDebugInternalFrame2 オブジェクト) の配列を返します。
HRESULT GetActiveInternalFrames
(
[in] ULONG32 cInternalFrames,
[out] ULONG32 *pcInternalFrames,
[in, out,size_is(cInternalFrames), length_is(*pcInternalFrames)]
ICorDebugInternalFrame2 * ppInternalFrames[]
);
パラメーター
cInternalFrames
[入力] ppInternalFrames で必要な内部フレームの数。pcInternalFrames
[出力] スタック上の内部フレームの数を格納する ULONG32 へのポインター。ppInternalFrames
[入力、出力] スタック上の内部フレームの配列のアドレスへのポインター。
戻り値
このメソッドは、次の特定の HRESULT と、メソッドの失敗を示す HRESULT エラーも返します。
HRESULT |
説明 |
---|---|
S_OK |
ICorDebugInternalFrame2 オブジェクトが正常に作成されました。 |
E_INVALIDARG |
cInternalFrames が 0 でなく、ppInternalFrames が null であるか、または pcInternalFrames が null です。 |
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) |
ppInternalFrames が内部フレームの数未満です。 |
解説
内部フレームは、一時データを保存するためにランタイムによってスタックにプッシュされるデータ構造です。
GetActiveInternalFrames の最初の呼び出しでは、cInternalFrames パラメーターを 0 (ゼロ) に、ppInternalFrames パラメーターを null に設定します。 GetActiveInternalFrames から最初に返される pcInternalFrames に、スタック上の内部フレームの数が格納されます。
その後にもう一度、GetActiveInternalFrames を呼び出します。 cInternalFrames パラメーターの適切な数 (pcInternalFrames) を渡し、ppInternalFrames の適切なサイズの配列へのポインターを指定します。
実際のスタック フレームを返すには、ICorDebugStackWalk::GetFrame を使用します。
必要条件
プラットフォーム: 「.NET Framework システム要件」を参照
ヘッダー: CorDebug.idl、CorDebug.h
ライブラリ: CorGuids.lib
.NET Framework のバージョン: 4