ICLRDataTarget3::GetExceptionContextRecord 方法
由通用語言執行平台 (CLR) 資料存取服務呼叫,用於擷取與目標處理序相關聯的內容記錄。 例如,針對傾印目標,這相當於透過 自變數傳入ExceptionParam
的 Windows 偵錯說明連結庫 (DbgHelp) 中 MiniDumpWriteDump 函式的內容記錄。
語法
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 以來可用