Функция RoCaptureErrorContext (roerrorapi.h)

Статья
03/01/2024

Сохраняет текущий контекст ошибки, чтобы он был доступен для последующих вызовов функции RoFailFastWithErrorContext .

Синтаксис

HRESULT RoCaptureErrorContext(
  HRESULT hr
);

Параметры

hr

HRESULT, связанный с ошибкой.

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

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Функция RoCaptureErrorContext фиксирует контекст, связанный с ошибкой, включая стек-backtrace. Эти сведения хранятся в объекте ограниченной ошибки и доступны службе отчеты об ошибках Windows (WER), если включена функция WER и если последующий вызов функции RoFailFastWithErrorContext из того же потока.

Чтобы использовать функцию RoCaptureErrorContext с RoOriginateError, сначала вызовите RoOriginateError , а затем вызовите RoCaptureErrorContext. Вызов в обратном порядке может привести к потере контекста ошибки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	roerrorapi.h
Библиотека	RuntimeObject.lib
DLL	ComBase.dll

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

IRestrictedErrorInfo

RoFailFastWithErrorContext

RoOriginateError

RoOriginateErrorW

Share via