메인 콘텐츠로 건너뛰기

WdCancelRemoteDelete

삭제 작업에 대한 클라이언트 대기의 취소를 시그널합니다. 도입된 릴리스: RIT 0.0.13-preview.

구문

매개 변수

_In_ cancellationHandle
형식: WdCancellationHandle
WdCreateCancellationHandle로 생성되어 WdDeleteRemoteFiles에 전달된 취소 핸들입니다. 이 핸들을 시그널링하면 클라이언트 대기의 취소가 요청됩니다.

반환 값

형식: HRESULT 성공 시 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

설명

블로킹 WdDeleteRemoteFiles 호출의 취소를 시그널하려면 별도의 스레드에서 WdCancelRemoteDelete를 호출합니다. WdCancelRemoteDelete는 논블로킹 함수입니다. WdDeleteRemoteFiles가 시그널을 감지하면 대기를 중지하고 엔드포인트 완료를 확인하지 않은 채 S_OK를 반환합니다. 감지된 취소와 정상 완료 모두 S_OK를 반환하므로, 취소할 수 있는 호출자는 반환 값만으로는 결과를 판단할 수 없습니다. 두 경우를 구분해야 하는 경우(예: 사용자가 시작한 취소 후 오류 메시지를 표시하지 않거나 재시도를 건너뛰려는 경우) 자체 코드에서 취소 상태를 추적합니다. 취소는 엔드포인트에서 이미 시작된 삭제를 중지하지 않으며, 해당 삭제는 독립적으로 계속됩니다. 이미 삭제된 항목을 복원하지도 않습니다.

요구 사항

함께 보기

마지막 수정일 2026년 10월 6일