WdCreateCancellationHandle
WdRemoteCopy で開始されたコピー操作をキャンセルするために使用できるキャンセル ハンドルを作成します。構文
パラメーター
_Out_ cancellationHandleType: WdCancellationHandle* 新しく作成されたキャンセル ハンドルを受け取ります。呼び出し元は、不要になったときに WdCloseCancellationHandle を呼び出してこのハンドルを解放する必要があります。
戻り値
Type: HRESULT 成功した場合はS_OK を返します。それ以外の場合はエラー コードを返します。
解説
コピー操作を開始する前にWdCreateCancellationHandle を呼び出して、キャンセルを有効にするハンドルを取得します。cancellationHandle パラメーターを介して WdRemoteCopy にハンドルを渡し、次に別のスレッドから WdCancelRemoteCopy にそれを渡して操作をキャンセルします。
WdRemoteCopy が戻った後、WdCloseCancellationHandle を呼び出してハンドルを閉じます。ハンドルは複数の WdRemoteCopy 呼び出しにわたって再利用できますが、各ハンドルは最終的に閉じる必要があります。