Поделиться через

Метод 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.

См. также раздел