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

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

Синтаксис

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

Параметры

[out] ppRestrictedErrorInfo

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

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

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

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

Замечания

Вызовите функцию GetRestrictedErrorInfo , чтобы получить последний набор объекта IRestrictedErrorInfo в текущем потоке в приложении Магазина Windows.

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

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

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

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

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 8 [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2012 [классические приложения | Приложения UWP]
целевая платформа	Виндоус
Header	roerrorapi.h
Library	mincore.lib
DLL	Combase.dll

См. также

GetErrorInfo

IRestrictedErrorInfo

RO_ERROR_REPORTING_FLAGS

RoCaptureErrorContext

RoFailFastWithErrorContext

SetRestrictedErrorInfo