IBackgroundCopyFile3::GetTemporaryName 메서드(bits3_0.h)

  • 아티클

다운로드 내용이 포함된 임시 파일의 전체 경로를 가져옵니다.

구문

HRESULT GetTemporaryName(
  [out] LPWSTR *pFilename
);

매개 변수

[out] pFilename

임시 파일의 전체 경로를 포함하는 Null로 끝나는 문자열입니다. 완료되면 CoTaskMemFree 함수를 호출하여 ppFileName 을 해제합니다.

반환 값

메서드는 다음 반환 값을 반환합니다.

반환 코드 Description
S_OK
 Success

설명

애플리케이션은 이 메서드를 사용하여 작업이 완료되기 전에 데이터에 액세스할 수 있습니다. 공유 쓰기 액세스(FILE_SHARE_WRITE)에 대한 파일을 엽니다. 전송되어 읽기에 사용할 수 있는 바이트 수를 확인하려면 IBackgroundCopyFile::GetProgress 메서드를 호출합니다. URL의 타임스탬프를 변경하면 진행률 정보가 다시 0으로 설정됩니다.

BITS가 파일 전송을 시작할 때까지 읽기 위해 파일을 열지 마세요. 그렇지 않으면 작업이 일시적인 오류 상태로 전환됩니다.

임시 파일은 애플리케이션이 IBackgroundCopyJob::Complete 또는 IBackgroundCopyJob::Cancel 메서드를 호출하거나 JobInactivityTimeout 그룹 정책이 만료될 때까지 사용할 수 있습니다. Complete 또는 Cancel 메서드를 호출하기 전에 임시 파일로 핸들을 해제해야 합니다.

임시 파일의 ACL은 Complete 가 호출될 때 최종 파일의 ACL과 동일합니다(ACL은 폴더에서 상속됨).

BITS가 파일 전송을 완료했는지 확인하려면 다음을 수행할 수 있습니다.

요구 사항

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

추가 정보

IBackgroundCopyCallback2::FileTransferred

IBackgroundCopyFile3