Skip to main content

WdCreateCancellationHandle

建立可用來取消由 WdRemoteCopy 啟動之複製作業的取消控制代碼。

語法

參數

_Out_ cancellationHandle
類型:WdCancellationHandle*
接收新建立的取消控制代碼。呼叫端負責在不再需要此控制代碼時呼叫 WdCloseCancellationHandle 加以釋放。

傳回值

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

備註

在開始複製作業之前呼叫 WdCreateCancellationHandle,以取得可啟用取消的控制代碼。透過 cancellationHandle 參數將控制代碼傳遞給 WdRemoteCopy,然後從另一個執行緒將它傳遞給 WdCancelRemoteCopy 以取消作業。 WdRemoteCopy 傳回之後,請呼叫 WdCloseCancellationHandle 關閉控制代碼。控制代碼可以在多次 WdRemoteCopy 呼叫之間重複使用,但每個控制代碼最終都必須關閉。

需求

另請參閱

Last modified on October 6, 2026