RpcErrorClearInformation function (rpcasync.h)

The RpcErrorClearInformation function clears all extended error information on the current thread.

Syntax

void RpcErrorClearInformation();

This function has no return values.

Note For a list of valid error codes, see RPC Return Values.

The RPC Runtime usually handles the clearing of extended error information. In only two cases should callers use RpcErrorClearInformation:

If the calling component adds records to the thread using the RpcErrorAddRecord function, then decides it has not encountered a fatal error and continues processing the original, or the error is not connected to the records is has added. In this case, the calling component needs to clear the error information from the thread to prevent the propagation of potentially misleading error information.
If the calling component attempts multiple retries of an operation that returns extended error information. When an RPC call starts, the RPC Runtime clears any extended error information on the thread. However, if the calling component calls RpcErrorAddRecord in a loop with many iterations, it may want to clear the error information, as the extended error information accumulates over time and can exhaust available memory.

Requirement	Value
Minimum supported client	Windows XP [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2003 [desktop apps \| UWP apps]
Target Platform	Windows
Header	rpcasync.h (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll