GetRestrictedErrorInfo 函数 （roerrorapi.h）

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

Syntax

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 函数。

要求

另请参阅

GetErrorInfo

IRestrictedErrorInfo

RO_ERROR_REPORTING_FLAGS

RoCaptureErrorContext

RoFailFastWithErrorContext

SetRestrictedErrorInfo