GetRestrictedErrorInfo 函数 (roerrorapi.h)

项目
03/01/2024

获取上一次调用当前逻辑线程中 SetRestrictedErrorInfo 设置的受限错误信息对象。

语法

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

参数

[out] ppRestrictedErrorInfo

与当前线程关联的受限错误信息对象。

返回值

此函数可以返回其中一个值。

返回代码	说明
S_OK	已成功检索受限制的错误对象。
S_FALSE	没有与当前线程关联的受限错误对象。任何其他错误对象都将从线程中删除。

注解

调用 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