RpcErrorClearInformation 函式 (rpcasync.h)

RpcErrorClearInformation 函式會清除目前線程上所有擴充的錯誤資訊。

Syntax

void RpcErrorClearInformation();

此函式沒有傳回值。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

RPC 執行時間通常會處理擴充錯誤資訊的清除。在兩種情況下，呼叫端應該使用 RpcErrorClearInformation：

如果呼叫元件使用 RpcErrorAddRecord 函式將記錄新增至線程，則決定它未發生嚴重錯誤並繼續處理原始錯誤，或錯誤未連線至記錄已新增。在此情況下，呼叫元件必須清除線程的錯誤資訊，以避免傳播可能誤導的錯誤資訊。
如果呼叫元件嘗試多次重試傳回擴充錯誤信息的作業。當 RPC 呼叫啟動時，RPC 執行時間會清除線程上的任何擴充錯誤資訊。不過，如果呼叫元件在迴圈中呼叫 RpcErrorAddRecord ，而且有許多反覆專案，它可能會想要清除錯誤資訊，因為延伸的錯誤資訊會隨著時間累積而累積，而且可能會耗盡可用的記憶體。

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	rpcasync.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll