ICLRDataTarget3::GetExceptionContextRecord メソッド

  • [アーティクル]

ターゲット プロセスに関連付けられたコンテキスト レコードを取得するために、共通言語ランタイム (CLR: Common Language Runtime) データ アクセス サービスによって呼び出されます。 たとえば、ダンプ ターゲットについては、これは Windows デバッグ ヘルプ ライブラリ (DbgHelp) の MiniDumpWriteDump 関数に ExceptionParam 引数によって渡されたコンテキスト レコードと同じです。

構文

HRESULT GetExceptionContextRecord(
    [in] ULONG32 bufferSize,
    [out] ULONG32* bufferUsed,
    [out, size_is(bufferSize)] BYTE* buffer
);

パラメーター

bufferSize [in]入力バッファー サイズ (バイト単位)。 これはコンテキスト レコードを格納するのに十分な大きさである必要があります。

bufferUsed [out]バッファーに実際に書き込まれたバイト数を受け取る ULONG32 型へのポインター。

buffer [out]コンテキスト レコードのコピーを受け取るメモリ バッファーへのポインター。 例外レコードは CONTEXT 型として返されます。

戻り値

戻り値は、成功の場合は S_OK で、失敗の場合は HRESULT コードです。 次が HRESULT コードに含まれることはありますが、限定されているわけではありません。

リターン コード 説明
S_OK メソッドが成功しました。 コンテキスト レコードは出力バッファーにコピーされました。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) コンテキスト レコードはターゲットに関連付けられていません。
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) 入力バッファーのサイズが足りないため、コンテキスト レコードを格納できません。

解説

CONTEXT は Windows SDK によって提供されるヘッダーで定義されているプラットフォーム固有の構造体です。

このメソッドは、デバッグ アプリケーションの作成者によって実装されます。

必要条件

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

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

ライブラリ: CorGuids.lib

.NET Framework のバージョン: 2013 年 11 月の 4.5.1 への更新以降で使用可能

関連項目