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
[in]入力バッファー サイズ (バイト単位)。 これは、sizeof(
MINIDUMP_EXCEPTION)
と等しい必要があります。
bufferUsed
[out]バッファーに実際に書き込まれたバイト数を受け取る ULONG32
型へのポインター。
buffer
[out]例外レコードのコピーを受け取るメモリ バッファーへのポインター。 例外レコードは、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 への更新以降で使用可能
関連項目
.NET