共用方式為

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 通用語言執行平台 (CLR) 尚未載入處理序，或 CLR 處於無法成功執行受控程式碼或處理呼叫的狀態。
HOST_E_TIMEOUT 呼叫逾時。
HOST_E_NOT_OWNER 呼叫端未擁有鎖定。
HOST_E_ABANDONED 封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。
E_FAIL 發生未知的嚴重失敗。 方法傳回 E_FAIL 之後，就無法在處理序中使用 CLR。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

備註

BeginCustomDump 方法會設定自訂堆積傾印設定。 EndCustomDump 方法會清除自訂堆積傾印組態，並釋放任何相關聯的狀態。 請在自訂堆積傾印完成後呼叫此方法。

重要

未能呼叫 EndCustomDump 將會導致記憶體流失。

規格需求

平台：請參閱系統需求。

標題： MSCorEE.h

程式庫：包含作為 MSCorEE.dll 中的資源

.NET Framework版本：自 2.0 起可用

另請參閱