GetRestrictedErrorInfo 函数 (roerrorapi.h)
获取上一次调用当前逻辑线程中 SetRestrictedErrorInfo 设置的受限错误信息对象。
语法
HRESULT GetRestrictedErrorInfo(
[out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);
参数
[out] ppRestrictedErrorInfo
与当前线程关联的受限错误信息对象。
返回值
此函数可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
已成功检索受限制的错误对象。 |
|
没有与当前线程关联的受限错误对象。 任何其他错误对象都将从线程中删除。 |
注解
调用 GetRestrictedErrorInfo 函数以获取 Windows 应用商店应用中当前线程上最近设置的 IRestrictedErrorInfo 对象。
调用 RoCaptureErrorContext 函数以保存当前线程的错误信息。 调用 RoFailFastWithErrorContext 函数以引发异常、终止当前进程，并将错误报告给Windows 错误报告服务 (WER) 。
GetRestrictedErrorInfo 将错误对象的所有权转让给调用方，并清除线程的错误状态。 如果最近设置的错误对象不支持 IRestrictedErrorInfo 接口，则清除线程的错误状态，但不会向调用方返回任何接口。
GetRestrictedErrorInfo 从当前线程检索错误对象，并调用 QueryInterface 来查找 IRestrictedErrorInfo 接口。 如果未找到 IRestrictedErrorInfo，GetRestrictedErrorInfo 将返回S_FALSE。 在这种情况下，将从线程中删除错误对象。 有关详细信息，请参阅 GetErrorInfo。
如果 IRestrictedErrorInfo 不是系统实现，则调用 GetRestrictedErrorInfo 函数失败。 若要创建 IRestrictedErrorInfo 对象，请调用 OriginateError、 TransformError 或 RoCaptureErrorContext 函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2012 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | roerrorapi.h |
| DLL | Combase.dll |