ICorDebugThread3::GetActiveInternalFrames メソッド

スタック上の内部フレーム (ICorDebugInternalFrame2 オブジェクト) の配列を返します。

構文

HRESULT GetActiveInternalFrames
      (
      [in] ULONG32 cInternalFrames,
      [out] ULONG32 *pcInternalFrames,
      [in, out,size_is(cInternalFrames), length_is(*pcInternalFrames)]
            ICorDebugInternalFrame2 * ppInternalFrames[]
      );

パラメーター

cInternalFrames [in] ppInternalFramesで想定される内部フレームの数。

pcInternalFrames [out]スタック上の内部フレームの数を含む ULONG32 へのポインター。

ppInternalFrames [入力、出力]スタック上の内部フレームの配列のアドレスへのポインター。

戻り値

このメソッドは、次の特定の HRESULT と、メソッドエラーを示す HRESULT エラーを返します。

HRESULT	Description
S_OK	ICorDebugInternalFrame2 オブジェクトが正常に作成されました。
E_INVALIDARG	cInternalFrames が 0 ではなく、 ppInternalFrames が nullされているか、 pcInternalFrames が null。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	ppInternalFrames が内部フレームの数よりも小さい。

Exceptions

注釈

内部フレームは、一時データを格納するためにランタイムによってスタックにプッシュされるデータ構造です。

GetActiveInternalFramesを初めて呼び出すときは、cInternalFrames パラメーターを 0 (ゼロ) に設定し、ppInternalFrames パラメーターを null に設定する必要があります。 最初 GetActiveInternalFrames 戻るときに、 pcInternalFrames にはスタック上の内部フレームの数が含まれます。

GetActiveInternalFrames は、2 回目に呼び出す必要があります。 cInternalFrames パラメーターに適切な数 (pcInternalFrames) を渡し、ppInternalFramesで適切なサイズの配列へのポインターを指定する必要があります。

実際のスタック フレームを返すには、 ICorDebugStackWalk::GetFrame メソッドを使用します。

Requirements

プラットフォーム：サポートされている .NET オペレーティング システムを参照してください。

ヘッダ： CorDebug.idl、CorDebug.h

図書館： CorGuids.lib

.NET のバージョン: .NET Framework 4.0 以降で使用可能