共用方式為


ICLRErrorReportingManager::BeginCustomDump 方法

指定用於報告錯誤的自訂堆積傾印組態。

HRESULT BeginCustomDump (
    [in] ECustomDumpFlavor dwFlavor,
    [in] DWORD dwNumItems,
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],
    DWORD dwReserved
);

參數

  • dwFlavor
    [in] ECustomDumpFlavor 值,指出要用來建置自訂堆積傾印的堆積傾印類型。

  • dwNumItems
    [in] items 陣列的長度。 如果 dwFlavor 不是 DUMP_FLAVOR_Mini,則 dwNumItems 應該是零。

  • items
    [in] CustomDumpItem 執行個體的陣列,指定要加入小型傾印中的項目。 如果 dwFlavor 不是 DUMP_FLAVOR_Mini,則 items 應該是 null。

  • dwReserved
    [in] 保留供日後使用。

傳回值

HRESULT

描述

S_OK

成功傳回方法。

HOST_E_CLRNOTAVAILABLE

Common Language Runtime (CLR) 尚未載入至處理序中,或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。

HOST_E_TIMEOUT

呼叫已逾時。

HOST_E_NOT_OWNER

呼叫端不具備鎖定功能。

HOST_E_ABANDONED

已封鎖執行緒或 Fiber 在等候事件時,該事件已遭取消。

E_FAIL

發生未知的重大錯誤。 在方法傳回 E_FAIL 之後,處理序中就無法再使用 CLR。 對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

備註

BeginCustomDump 方法會設定自訂堆積傾印組態。 EndCustomDump 方法會清除自訂堆積傾印組態,並釋放任何相關聯的狀態。 當自訂堆積傾印完成後,應該要進行呼叫。

重要事項重要事項

呼叫 EndCustomDump 失敗會造成記憶體遺漏。

需求

**平台:**請參閱 .NET Framework 系統需求

**標頭:**MSCorEE.h

程式庫:包含做為 MSCorEE.dll 中的資源

**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

請參閱

參考

CustomDumpItem 結構

ECustomDumpFlavor 列舉

ICLRErrorReportingManager 介面