WdDuplicateCancellationHandle
既存の WdCancellationHandle を複製します。構文
パラメーター
_In_ cancellationHandleType: WdCancellationHandle 複製するキャンセル ハンドル。
_Out_ duplicatedHandleType: WdCancellationHandle* 複製されたキャンセル ハンドルを受け取ります。呼び出し元は、WdCloseCancellationHandle を呼び出してこのハンドルを個別に閉じる必要があります。
戻り値
Type: HRESULT 成功した場合はS_OK を返します。それ以外の場合はエラー コードを返します。
解説
複数のコンポーネントが同じキャンセル ハンドルを参照する必要がある場合は、WdDuplicateCancellationHandle を使用します。元のハンドルと複製されたハンドルはどちらも同じキャンセル状態を参照しており、いずれかのハンドルで WdCancelRemoteCopy を介してキャンセルをシグナルすると、関連付けられた WdRemoteCopy 操作がキャンセルされます。各ハンドルは WdCloseCancellationHandle で個別に閉じる必要があります。