共用方式為


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

另請參閱

取得擴充 RPC 錯誤資訊

RpcErrorAddRecord

RpcErrorGetNextRecord

RpcErrorStartEnumeration