Метод ICLRDataTarget3::GetExceptionContextRecord

  • Статья

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

Синтаксис

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

Параметры

bufferSize
[в] Размер входного буфера в байтах. Он должен быть достаточно большим, чтобы вместить запись контекста.

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

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

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

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

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

Комментарии

CONTEXT — это структура конкретной платформы, определенная в заголовках, предоставляемых пакетом Windows SDK.

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

Требования

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

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

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

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

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