WdCancelRemoteCopy
取消進行中的複製作業。語法
參數
_In_ cancellationHandle類型:WdCancellationHandle 由 WdCreateCancellationHandle 建立並傳遞給 WdRemoteCopy 的取消控制代碼。對此控制代碼發出訊號會導致進行中的複製遭到取消。
傳回值
類型:HRESULT 如果成功,則傳回S_OK;否則傳回錯誤碼。
備註
從另一個執行緒呼叫WdCancelRemoteCopy,以取消封鎖中的 WdRemoteCopy 呼叫。WdCancelRemoteCopy 是發出取消訊號的非封鎖函式;WdRemoteCopy 可能會傳回 S_OK 或失敗。
由於 WdRemoteCopy 在觀察到取消後可能傳回任一種結果,因此單憑傳回值無法判斷作業是遭到取消還是執行完成。如果您需要區分這兩者,請在自己的程式碼中追蹤取消狀態,例如在使用者起始取消之後隱藏錯誤訊息或略過重試。
