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 |