WdCreateCancellationHandle
建立可用來取消由 WdRemoteCopy 啟動之複製作業的取消控制代碼。語法
參數
_Out_ cancellationHandle類型:WdCancellationHandle* 接收新建立的取消控制代碼。呼叫端負責在不再需要此控制代碼時呼叫 WdCloseCancellationHandle 加以釋放。
傳回值
類型:HRESULT 如果成功,則傳回S_OK;否則傳回錯誤碼。
備註
在開始複製作業之前呼叫WdCreateCancellationHandle,以取得可啟用取消的控制代碼。透過 cancellationHandle 參數將控制代碼傳遞給 WdRemoteCopy,然後從另一個執行緒將它傳遞給 WdCancelRemoteCopy 以取消作業。
WdRemoteCopy 傳回之後,請呼叫 WdCloseCancellationHandle 關閉控制代碼。控制代碼可以在多次 WdRemoteCopy 呼叫之間重複使用,但每個控制代碼最終都必須關閉。
