Метод ICLRDataTarget3::GetExceptionRecord

Статья
11/05/2024

Вызывается службами доступа к данным среды CLR для извлечения записи исключения, связанной с целевым процессом. Например, для целевого объекта дампа это эквивалентно записи исключений, переданной через ExceptionParam аргумент функции MiniDumpWriteDumpDump в библиотеке справки отладки Windows (DbgHelp).

Синтаксис

HRESULT GetExceptionRecord(
    [in] ULONG32 bufferSize,
    [out] ULONG32* bufferUsed,
    [out, size_is(bufferSize] BYTE* buffer
);

Параметры

bufferSize [in] Размер входного буфера в байтах. Это должно быть равно sizeof(MINIDUMP_EXCEPTION).

bufferUsed [out] Указатель на ULONG32 тип, который получает количество байтов, фактически записанных в буфер.

buffer [out] Указатель на буфер памяти, получающий копию записи исключений. Запись исключения возвращается как тип MINIDUMP_EXCEPTION .

Возвращаемое значение

Возвращается значение S_OK при успешном выполнении или код ошибки HRESULT при сбое. Коды HRESULT могут включать значения, приведенные в следующей таблице.

Код возврата	Description
`S_OK`	Метод успешно выполнен. Запись исключения скопирована в буфер вывода.
`HRESULT_FROM_WIN32(ERROR_NOT_FOUND)`	Нет записей исключения, связанных с целевым объектом.
`HRESULT_FROM_WIN32(ERROR_BAD_LENGTH)`	Размер входного буфера не равен `sizeof(MINIDUMP_EXCEPTION)`.

Замечания

MINIDUMP_EXCEPTION — это структура, определенная в dbghelp.h и imagehlp.h в пакете SDK для Windows.

Этот метод реализуется модулем записи отладчика.

Требования

Платформы: см. раздел Требования к системе.

Заголовок: ClrData.idl, ClrData.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: Доступно с ноября 2013 г. обновление до версии 4.5.1

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