ICLRDataTarget3::GetExceptionRecord メソッド

  • [アーティクル]

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

構文

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

パラメーター

bufferSize
[入力] 入力バッファー サイズ (バイト単位)。 これは、sizeof(MINIDUMP_EXCEPTION) と等しい必要があります。

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

buffer
[出力] 例外レコードのコピーを受信するメモリ バッファーへのポインター。 例外レコードは、MINIDUMP_EXCEPTION 型として返されます。

戻り値

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

リターン コード 説明
S_OK メソッドが成功しました。 例外レコードは出力バッファーにコピーされました。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) 例外レコードはターゲットに関連付けられていません。
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) 入力バッファーのサイズは sizeof(MINIDUMP_EXCEPTION) と等しくありません。

解説

MINIDUMP_EXCEPTION は Windows SDK の dbghelp.h および imagehlp.h で定義されている構造体です。

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

必要条件

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

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

ライブラリ: CorGuids.lib

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

関連項目