Метод ICLRErrorReportingManager::BeginCustomDump

Статья
11/16/2008

Обновлен: Ноябрь 2007

Задает конфигурацию пользовательских дампов кучи для отчета об ошибках.

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.

Заметки

Метод BeginCustomDump задает конфигурацию пользовательского дампа кучи. Метод EndCustomDump очищает конфигурацию пользовательского дампа кучи и освобождает все связанные с ней состояния. Его следует вызывать после завершения пользовательского дампа кучи.