rpcErrorClearInformation 函数 (rpcasync.h)

RpcErrorClearInformation 函数清除当前线程上的所有扩展错误信息。

语法

void RpcErrorClearInformation();

此函数没有返回值。

注意有关有效错误代码的列表，请参阅 RPC 返回值。

RPC 运行时通常处理扩展错误信息的清除。在只有两种情况下，调用方应使用 RpcErrorClearInformation：

如果调用组件使用 RpcErrorAddRecord 函数将记录添加到线程中，则确定它未遇到严重错误并继续处理原始错误，或者错误未连接到已添加的记录。在这种情况下，调用组件需要清除线程中的错误信息，以防止传播潜在的误导性错误信息。
如果调用组件尝试多次重试返回扩展错误信息的操作。 RPC 调用启动时，RPC 运行时会清除线程上的任何扩展错误信息。但是，如果调用组件在具有多次迭代的循环中调用 RpcErrorAddRecord ，则它可能需要清除错误信息，因为扩展的错误信息会随时间推移而累积，并可能耗尽可用内存。