RoCaptureErrorContext 函数 (roerrorapi.h)

保存当前错误上下文，以便以后可以调用 RoFailFastWithErrorContext 函数。

语法

HRESULT RoCaptureErrorContext(
  HRESULT hr
);

hr

与错误关联的 HRESULT 。

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

RoCaptureErrorContext 函数捕获与错误关联的上下文，包括堆栈回溯。此信息存储在受限错误对象中，如果启用了 WER，并且从同一线程对 RoFailFastWithErrorContext 函数进行了后续调用，则可用于Windows 错误报告 (WER) 服务。

若要将 RoCaptureErrorContext 函数与 RoOriginateError 一起使用，请先调用 RoOriginateError ，然后调用 RoCaptureErrorContext。按反向顺序调用可能会导致错误上下文丢失。