IBackgroundCopyCallback2::FileTransferred 메서드(bits3_0.h)

BITS는 BITS가 파일 전송을 성공적으로 완료하면 FileTransferred 메서드의 구현을 호출합니다.

구문

HRESULT FileTransferred(
  [in] IBackgroundCopyJob  *pJob,
  [in] IBackgroundCopyFile *pFile
);

매개 변수

[in] pJob

작업 관련 정보를 포함합니다. pJob을 해제하지 마세요. BITS는 이 메서드가 반환될 때 인터페이스를 해제합니다.

[in] pFile

파일 관련 정보를 포함합니다. pFile을 해제하지 마세요. BITS는 이 메서드가 반환될 때 인터페이스를 해제합니다.

반환 값

이 메서드는 S_OK 반환해야 합니다. 그렇지 않으면 음수인 경우 BITS는 S_OK 반환될 때까지 이 메서드를 계속 호출합니다. 성능상의 이유로 S_OK 이외의 값을 반환하는 횟수를 몇 번으로 제한해야 합니다. 오류 코드를 반환하는 대신 항상 S_OK 반환하고 내부적으로 오류를 처리하는 것이 좋습니다. 이 메서드가 호출되는 간격은 임의입니다.

설명

일반적으로 다운로드한 파일의 콘텐츠의 유효성을 검사하지 않는 한 이 콜백을 사용하지 않습니다. 피어에 제공될 수 있는 콘텐츠를 다운로드하는 경우 파일의 유효성을 검사하는 것이 중요할 수 있습니다.

다운로드한 콘텐츠가 포함된 임시 파일의 이름을 얻으려면 IBackgroundCopyFile3::GetTemporaryName 메서드를 호출합니다. 콘텐츠를 확인한 후 IBackgroundCopyFile3::SetValidationState 메서드를 호출하여 파일 내용이 유효한지 BITS에 나타냅니다. 유효성 검사 상태를 FALSE 로 설정하고 콘텐츠가 원본 서버에서 온 경우 작업이 오류 상태로 이동합니다.

콘텐츠가 피어에서 온 경우 BITS는 원본 서버에서 파일을 다운로드합니다. 원본 서버에서 파일 전송이 완료된 후 콜백이 다시 호출됩니다.

BITS 3.0: 원본 서버에서 파일 전송이 완료된 후에는 콜백이 다시 호출되지 않습니다.

작업의 경우 FileTransferred 콜백이 serialize됩니다. BITS는 현재 콜백이 성공적으로 반환될 때까지 작업의 다음 파일에 대한 콜백을 디스패치하지 않습니다.

FileTransferred 콜백은 JobTransferred 및 JobError 콜백 전에 디스패치됩니다.

FileTransferred 콜백은 업로드-회신 작업의 다운로드 작업 또는 회신 부분을 위한 것입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	bits3_0.h(Bits.h 포함)
라이브러리	Bits.lib

추가 정보

IBackgroundCopyCallback

IBackgroundCopyCallback2