WdCancellationHandle

진행 중인 복사 작업을 취소하는 데 사용되는 불투명 핸들입니다.

구문

typedef struct WdCancellationHandleImpl* WdCancellationHandle;

설명

WdCancellationHandle은 불투명한 내부 구조체에 대한 typedef 포인터입니다. 호출자는 핸들 수명 주기를 관리할 책임이 있습니다:

WdCreateCancellationHandle을 호출하여 핸들을 생성합니다.
cancellationHandle 매개 변수를 통해 WdRemoteCopy에 핸들을 전달합니다.
진행 중인 복사를 취소하려면 별도의 스레드에서 핸들과 함께 WdCancelRemoteCopy를 호출합니다.
WdRemoteCopy가 반환된 후 WdCloseCancellationHandle을 호출하여 핸들을 닫습니다.

핸들은 WdDuplicateCancellationHandle을 사용하여 복제할 수 있습니다. 각 핸들 복사본은 WdCloseCancellationHandle로 독립적으로 닫아야 합니다.

요구 사항

요구 사항	값
헤더	WdRemoteIteration.h
라이브러리	wdremoteapi.lib
지원 OS	Windows 11 이상
지원 아키텍처	x64, ARM64

함께 보기

마지막 수정일 2026년 8월 24일

관련 항목

WdDuplicateCancellationHandle WdCloseCancellationHandle WdCreateCancellationHandle WdCancelRemoteCopy WdRemoteCopy

⌘I