ICorDebugStackWalk::GetContext メソッド

  • [アーティクル]

ICorDebugStackWalk オブジェクト内の現在のフレームのコンテキストを返します。

構文

HRESULT GetContext([in]  ULONG32 contextFlags,
                   [in]  ULONG32 contextBufSize,
                   [out] ULONG32* contextSize,
                   [out, size_is(contextBufSize)] BYTE contextBuf[]);

パラメーター

contextFlags [in]コンテキスト バッファーの要求された内容を示すフラグ (WinNT.h で定義)。

contextBufSize [in]コンテキスト バッファーの割り当てられたサイズ。

contextSize [out]コンテキストの実際のサイズ。 この値は、コンテキスト バッファーのサイズ以下である必要があります。

contextBuf [out]コンテキスト バッファー。

戻り値

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

HRESULT 説明
S_OK 現在のフレームのコンテキストが正常に返されました。
E_FAIL コンテキストを返すことができませんでした。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT BUFFER) コンテキスト バッファーが小さすぎます。
CORDBG_E_PAST_END_OF_STACK フレーム ポインターは既にスタックの末尾にあります。そのため、アクセスできる追加のフレームはありません。

例外

解説

アンワインドではレジスタのサブセット (例: 不揮発性レジスタ) だけが復元されるため、コンテキストが、呼び出し時点でのレジスタの状態と正確には一致しないことがあります。

必要条件

:「システム要件」を参照してください。

ヘッダー: CorDebug.idl、CorDebug.h

ライブラリ: CorGuids.lib

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

関連項目