ICLRDataTarget3::GetExceptionRecord 方法
由通用語言執行平台 (CLR) 資料存取服務呼叫,用於擷取與目標處理序相關聯的例外狀況記錄。 例如,針對傾印目標,這相當於透過自變數傳入 ExceptionParam
的例外狀況記錄,而 Windows 偵錯說明連結庫 (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是在 dbghelp.h 和 Windows SDK 中 imagehlp.h 中定義的結構。
此方法是由偵錯應用程式的作者來實作。
需求
平台:請參閱系統需求。
標頭: ClrData.idl、ClrData.h
程式庫:CorGuids.lib
.NET Framework 版本: 自 2013 年 11 月更新至 4.5.1 以來可用