Skip to main content

WdCancelRemoteCopy

取消進行中的複製作業。

語法

參數

_In_ cancellationHandle
類型:WdCancellationHandle
由 WdCreateCancellationHandle 建立並傳遞給 WdRemoteCopy 的取消控制代碼。對此控制代碼發出訊號會導致進行中的複製遭到取消。

傳回值

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

備註

從另一個執行緒呼叫 WdCancelRemoteCopy,以取消封鎖中的 WdRemoteCopy 呼叫。WdCancelRemoteCopy 是發出取消訊號的非封鎖函式;WdRemoteCopy 可能會傳回 S_OK 或失敗。 由於 WdRemoteCopy 在觀察到取消後可能傳回任一種結果,因此單憑傳回值無法判斷作業是遭到取消還是執行完成。如果您需要區分這兩者,請在自己的程式碼中追蹤取消狀態,例如在使用者起始取消之後隱藏錯誤訊息或略過重試。

需求

另請參閱

Last modified on October 6, 2026