IBackgroundCopyJob::Cancel 메서드(bits.h)

전송 큐에서 작업을 삭제하고 클라이언트(다운로드) 및 서버(업로드)에서 관련 임시 파일을 제거합니다.

구문

HRESULT Cancel();

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드	설명
S_OK	작업이 취소되었습니다.
BG_S_UNABLE_TO_DELETE_FILES	작업이 성공적으로 취소되었습니다. 그러나 서비스에서 작업과 연결된 임시 파일을 삭제할 수 없습니다.
BG_E_INVALID_STATE	상태가 BG_JOB_STATE_CANCELLED 또는 BG_JOB_STATE_ACKNOWLEDGED 작업을 취소할 수 없습니다.

설명

언제든지 작업을 취소할 수 있습니다. 그러나 작업이 취소된 후에는 복구할 수 없습니다.

업로드 작업의 경우 서버를 사용할 수 없는 경우 BITS가 큐에서 작업을 삭제하기 전에 지연이 있을 수 있습니다. BITS는 최대 24시간 동안 주기적으로 BITS 서버에 취소 요청을 보냅니다. 서버가 24시간 내에 응답하지 않으면 BITS는 큐에서 작업을 제거합니다. 진행되지 않는 시간 제한 기간이 24시간 미만인 경우 BITS는 진행률 없음 제한 시간을 사용하여 재시도를 제한합니다.

업로드가 완료되지 않은 경우 Cancel 메서드는 업로드를 취소합니다. 업로드가 완료되고 작업이 BG_JOB_TYPE_UPLOAD_REPLY 형식이면 메서드가 회신을 취소합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	Windows
헤더	bits.h
라이브러리	Bits.lib
DLL	QmgrPrxy.dll

추가 정보

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend