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