IBackgroundCopyJob2::SetReplyFileName 메서드(bits1_5.h)
서버 애플리케이션의 회신 데이터를 포함할 파일의 이름을 지정합니다. 작업의 형식이 BG_JOB_TYPE_UPLOAD_REPLY 경우에만 이 메서드를 호출합니다.
구문
HRESULT SetReplyFileName(
[in] LPCWSTR ReplyFileName
);
매개 변수
[in] ReplyFileName
회신 파일의 전체 경로를 포함하는 Null로 종료된 문자열입니다. ReplyFileNamePathSpec이 NULL이거나 빈 문자열인 경우 BITS는 파일 이름을 생성합니다. 경로 또는 파일 이름에는 와일드카드를 사용할 수 없으며 경로의 디렉터리도 있어야 합니다. 경로는 null 종결자를 포함하지 않고 MAX_PATH 제한됩니다. 사용자에게 디렉터리에 쓸 수 있는 권한이 있어야 합니다. BITS는 NTFS 스트림을 지원하지 않습니다. 세션별 네트워크 드라이브를 사용하는 대신 UNC 경로(예: \server\share\path\file)를 사용합니다. \?을(를) 포함하지 마세요. 경로의 접두사입니다.
반환 값
이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
회신 데이터를 포함할 파일의 이름을 지정했습니다. |
|
BITS가 클라이언트에 회신을 전송하기 시작한 후에는 회신 파일 이름을 변경할 수 없습니다. 상태가 BG_JOB_STATE_TRANSFERRING 있고 BG_JOB_REPLY_PROGRESS 구조의 BytesTotal 멤버가 BG_SIZE_UNKNOWN않은 경우 BITS가 클라이언트에 회신을 전송합니다. |
|
사용자에게 클라이언트의 지정된 디렉터리에 쓸 수 있는 권한이 없습니다. |
|
회신 파일 이름이 잘못되었거나 MAX_PATH 초과합니다. |
설명
IBackgroundCopyJob::Resume 메서드를 처음 호출하기 전에 SetReplyFileName 메서드를 호출하지 않으면 BITS에서 파일 이름을 생성합니다.
BITS가 파일 이름을 생성하는 경우 회신 파일은 로컬 업로드 파일과 동일한 디렉터리에 기록됩니다.
BITS가 서버 애플리케이션에서 회신 다운로드를 시작하기 전에 언제든지 SetReplyFileName 메서드를 호출할 수 있습니다. 다운로드가 시작된 경우 메서드가 실패합니다.
IBackgroundCopyJob::Complete 메서드를 호출한 후 클라이언트에서 회신 파일을 사용할 수 있습니다. Complete 메서드를 호출하기 전에 회신 데이터를 검색하려면 IBackgroundCopyJob2::GetReplyData 메서드를 호출합니다.
서버 애플리케이션에서 회신을 제공하지 않은 경우 파일이 비어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2003 |
| 대상 플랫폼 | Windows |
| 헤더 | bits1_5.h(Bits.h 포함) |
| 라이브러리 | Bits.lib |
| DLL | BitsPrx2.dll |
| 재배포 가능 파일 | Windows XP의 BITS 1.5 |