WdCreateCancellationHandle
WdRemoteCopy로 시작된 복사 작업을 취소하는 데 사용할 수 있는 취소 핸들을 생성합니다.구문
매개 변수
_Out_ cancellationHandle형식: WdCancellationHandle* 새로 생성된 취소 핸들을 받습니다. 호출자는 더 이상 필요하지 않을 때 WdCloseCancellationHandle을 호출하여 이 핸들을 해제할 책임이 있습니다.
반환 값
형식: HRESULT 성공 시S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
설명
복사 작업을 시작하기 전에WdCreateCancellationHandle을 호출하여 취소를 가능하게 하는 핸들을 얻으세요. cancellationHandle 매개 변수를 통해 WdRemoteCopy에 핸들을 전달한 다음, 작업을 취소하려면 별도의 스레드에서 WdCancelRemoteCopy에 핸들을 전달하세요.
WdRemoteCopy가 반환된 후에는 WdCloseCancellationHandle을 호출하여 핸들을 닫으세요. 핸들은 여러 WdRemoteCopy 호출에서 재사용할 수 있지만, 결국 각 핸들은 닫아야 합니다.