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

Exceptions

注釈

アンワインドでは、非揮発性レジスタなどのレジスタのサブセットのみが復元されるため、呼び出し時にコンテキストがレジスタの状態と完全に一致しない可能性があります。

Requirements

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

ヘッダ： CorDebug.idl、CorDebug.h

図書館： CorGuids.lib

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