Функция GetRestrictedErrorInfo (roerrorapi.h)
Возвращает объект сведений об ограниченной ошибке, заданный предыдущим вызовом SetRestrictedErrorInfo в текущем логическом потоке.
Синтаксис
HRESULT GetRestrictedErrorInfo(
[out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);
Параметры
[out] ppRestrictedErrorInfo
Ограниченный объект сведений об ошибке, связанный с текущим потоком.
Возвращаемое значение
Эта функция может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Объект ограниченной ошибки был успешно получен. |
|
С текущим потоком не связан ограниченный объект ошибки. Любой другой объект ошибки удаляется из потока. |
Комментарии
Вызовите функцию GetRestrictedErrorInfo , чтобы получить последний заданный объект IRestrictedErrorInfo в текущем потоке в приложении Магазина Windows.
Вызовите функцию 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 |