ICLRErrorReportingManager::BeginCustomDump 方法

2008-08-18

更新：2007 年 11 月

为错误报告指定自定义堆转储配置。

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) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方不拥有锁。
HOST_E_ABANDONED	事件在被阻止的线程或纤程正在等待它时被取消。
E_FAIL	发生了未知的灾难性故障。在某方法返回 E_FAIL 后，CLR 便无法再在进程中使用。对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。