Skip to main content

WdCancelRemoteDelete

對刪除作業的用戶端等候發出取消訊號。 引進版本: RIT 0.0.13-preview。

語法

參數

_In_ cancellationHandle
類型:WdCancellationHandle
由 WdCreateCancellationHandle 建立並傳遞給 WdDeleteRemoteFiles 的取消控制代碼。對此控制代碼發出訊號會要求取消用戶端等候。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。

備註

從另一個執行緒呼叫 WdCancelRemoteDelete,以對封鎖中的 WdDeleteRemoteFiles 呼叫發出取消訊號。WdCancelRemoteDelete 是非封鎖函式。如果 WdDeleteRemoteFiles 觀察到該訊號,就會停止等候並傳回 S_OK,而不會確認端點是否完成。 由於觀察到取消和正常完成都會傳回 S_OK,可能取消的呼叫端無法單憑傳回值判斷結果。如果您需要區分這兩者,請在自己的程式碼中追蹤取消狀態,例如在使用者起始取消之後隱藏錯誤訊息或略過重試。 取消不會停止端點上已開始的刪除,刪除會獨立繼續進行。取消也不會還原已刪除的項目。

需求

另請參閱

Last modified on October 6, 2026