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 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 某方法返回 E_FAIL 后，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。

备注

BeginCustomDump 方法设置自定义堆转储配置。 EndCustomDump 方法清除自定义堆转储配置并释放任何关联状态。 应在完成自定义堆转储后调用。

重要

调用 EndCustomDump 失败会导致内存泄露。

要求

平台：请参阅系统要求。

标头：MSCorEE.h

库：作为资源包含在 MSCorEE.dll 中

.NET Framework 版本：自 2.0 起可用

另请参阅