ICorDebugStackWalk::GetContext メソッドICorDebugStackWalk::GetContext Method

は、テキストオブジェクト内の現在のフレームのコンテキストを返します。Returns the context for the current frame in the ICorDebugStackWalk object.

構文Syntax

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

パラメーターParameters

contextFlags
からコンテキストバッファーの要求されたコンテンツを示すフラグ (Winnt.h で定義されています)。[in] Flags that indicate the requested contents of the context buffer (defined in WinNT.h).

contextBufSize
からコンテキストバッファーに割り当てられたサイズ。[in] The allocated size of the context buffer.

contextSize
入出力コンテキストの実際のサイズ。[out] The actual size of the context. この値は、コンテキストバッファーのサイズ以下である必要があります。This value must be less than or equal to the size of the context buffer.

contextBuf
入出力コンテキストバッファー。[out] The context buffer.

戻り値Return Value

このメソッドは、次の特定の HRESULT と、メソッドの失敗を示す HRESULT エラーも返します。This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULTHRESULT 説明Description
S_OKS_OK 現在のフレームのコンテキストが正常に返されました。The context for the current frame was successfully returned.
E_FAILE_FAIL コンテキストを返すことができませんでした。The context could not be returned.
HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT バッファー)HRESULT_FROM_WIN32(ERROR_INSUFFICIENT BUFFER) コンテキストバッファーが小さすぎます。The context buffer is too small.
CORDBG_E_PAST_END_OF_STACKCORDBG_E_PAST_END_OF_STACK フレームポインターは既にスタックの末尾にあります。そのため、追加のフレームにアクセスすることはできません。The frame pointer is already at the end of the stack; therefore, no additional frames can be accessed.

例外Exceptions

RemarksRemarks

アンワインドでは、非揮発性レジスタなどのレジスタのサブセットのみが復元されるため、呼び出し時にコンテキストがレジスタの状態と完全に一致するとは限りません。Because unwinding restores only a subset of the registers, such as non-volatile registers, the context may not exactly match the register state at the time of the call.

必要条件Requirements

:システム要件」を参照してください。Platforms: See System Requirements.

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

ライブラリ: CorGuids.libLibrary: CorGuids.lib

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

関連項目See also