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 |