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

Статья
03/08/2023

Возвращает объект сведений об ограниченной ошибке, заданный предыдущим вызовом SetRestrictedErrorInfo в текущем логическом потоке.

Синтаксис

HRESULT GetRestrictedErrorInfo(
  [out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);

Параметры

[out] ppRestrictedErrorInfo

Ограниченный объект сведений об ошибке, связанный с текущим потоком.

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

Эта функция может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Объект ограниченной ошибки был успешно получен.
S_FALSE	С текущим потоком не связан ограниченный объект ошибки. Любой другой объект ошибки удаляется из потока.

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

GetRestrictedErrorInfo передает владение объектом ошибки вызывающей объекту и очищает состояние ошибки для потока. Если последний заданный объект ошибки не поддерживает интерфейс IRestrictedErrorInfo , состояние ошибки для потока очищается, но вызывающий объект не возвращает интерфейс.

GetRestrictedErrorInfo извлекает объект error из текущего потока и вызывает QueryInterface для поиска интерфейса IRestrictedErrorInfo. Если функция IRestrictedErrorInfo не найдена, метод GetRestrictedErrorInfo возвращает S_FALSE. В этом случае объект error удаляется из потока. Дополнительные сведения см. в разделе GetErrorInfo.

Вызов функции GetRestrictedErrorInfo завершается ошибкой , если IRestrictedErrorInfo не является системной реализацией. Чтобы создать объект IRestrictedErrorInfo , вызовите функции OriginateError, TransformError или RoCaptureErrorContext .

Требования

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