Метод ICLRDataTarget3::GetExceptionRecordICLRDataTarget3::GetExceptionRecord Method

Вызывается службами доступа к данным среды CLR для извлечения записи исключения, связанной с целевым процессом.Called by the common language runtime (CLR) data access services to retrieve the exception record associated with the target process. Например, для целевого объекта дампа это будет эквивалентно записи исключения, передаваемой через ExceptionParam аргумент в функцию Минидумпвритедумп в библиотеке справки по отладке Windows (DBGHELP).For example, for a dump target, this would be equivalent to the exception record passed in via the ExceptionParam argument to the MiniDumpWriteDump function in the Windows Debug Help Library (DbgHelp).

СинтаксисSyntax

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

ПараметрыParameters

bufferSize
[в] Размер входного буфера в байтах.[in] The input buffer size, in bytes. Оно должно быть равно sizeof( MINIDUMP_EXCEPTION ) .This must be equal to sizeof(MINIDUMP_EXCEPTION).

bufferUsed
[из] Указатель на тип ULONG32, который получает количество байтов, фактически записанных в буфер.[out] A pointer to a ULONG32 type that receives the number of bytes actually written to the buffer.

buffer
[из] Указатель на буфер памяти, который получает копию записи исключения.[out] A pointer to a memory buffer that receives a copy of the exception record. Запись исключения возвращается как тип MINIDUMP_EXCEPTION .The exception record is returned as a MINIDUMP_EXCEPTION type.

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

Возвращается значение S_OK при успешном выполнении или код ошибки HRESULT при сбое.The return value is S_OK on success, or a failure HRESULT code on failure. Коды HRESULT могут включать значения, приведенные в следующей таблице.The HRESULT codes can include but are not limited to the following:

Код возвратаReturn code ОписаниеDescription
S_OK Метод успешно выполнен.Method succeeded. Запись исключения скопирована в буфер вывода.The exception record has been copied to the output buffer.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Нет записей исключения, связанных с целевым объектом.No exception record is associated with the target.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) Размер входного буфера не равен sizeof(MINIDUMP_EXCEPTION).The input buffer size is not equal to sizeof(MINIDUMP_EXCEPTION).

RemarksRemarks

MINIDUMP_EXCEPTION — это структура, определенная в dbghelp. h и IMAGEHLP. h в Windows SDK.MINIDUMP_EXCEPTION is a structure defined in dbghelp.h and imagehlp.h in the Windows SDK.

Этот метод реализуется модулем записи отладчика.This method is implemented by the writer of the debugging application.

ТребованияRequirements

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

Заголовок: Клрдата. idl, Клрдата. hHeader: ClrData.idl, ClrData.h

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

Платформа .NET Framework версии:Поскольку обновление 4.5.1 в ноябре 2013 г.Available since November 2013 update to 4.5.1.NET Framework Versions: Поскольку обновление 4.5.1 в ноябре 2013 г.Available since November 2013 update to 4.5.1

См. такжеSee also