ICLRDataTarget3::GetExceptionRecord 方法

  • 發行項

由通用語言執行平台 (CLR) 資料存取服務呼叫，用於擷取與目標處理序相關聯的例外狀況記錄。 例如，對於傾印目標，這就相當於透過 ExceptionParam 引數傳遞至 Windows Debug Help Library (DbgHelp) 中 MiniDumpWriteDump 的例外狀況記錄。

語法

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 起提供

另請參閱