다음을 통해 공유

IBackgroundCopyJob2::GetReplyFileName 메서드(bits1_5.h)

  • 아티클

서버 애플리케이션에서 회신 데이터가 포함된 파일의 이름을 검색합니다. 작업 유형이 BG_JOB_TYPE_UPLOAD_REPLY 경우에만 이 메서드를 호출합니다.

구문

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

매개 변수

[out] pReplyFileName

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

반환 값

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

반환 코드 설명
S_OK
 회신 데이터가 포함된 파일의 이름을 성공적으로 검색했습니다.
E_NOTIMPL
 이 메서드는 형식 BG_JOB_TYPE_DOWNLOAD 또는BG_JOB_TYPE_UPLOAD 작업에 대해 구현되지 않습니다.

설명

회신 파일 이름을 지정하려면 IBackgroundCopyJob2::SetReplyFileName 메서드를 호출합니다. 이름을 지정하지 않은 경우 GetReplyFileName 메서드는 BITS에서 생성한 이름을 반환합니다. 이름을 지정하지 않고 작업에 파일을 추가하기 전에 이 메서드를 호출한 경우 pReplyFileName 은 NULL로 설정됩니다.

회신 파일을 열고 읽기 전에 IBackgroundCopyJob::Complete 메서드를 호출해야 합니다. Complete 메서드를 호출할 때까지 클라이언트에서 회신 파일을 사용할 수 없습니다.

서버 애플리케이션이 회신을 제공하지 않은 경우 파일이 비어 있습니다.

예제

GetReplyFileName 메서드를 사용하는 예제는 Upload-Reply 작업에서 회신 검색을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2003
대상 플랫폼 Windows
헤더 bits1_5.h(Bits.h 포함)
라이브러리 Bits.lib
DLL BitsPrx2.dll
재배포 가능 파일 Windows XP의 BITS 1.5

추가 정보

IBackgroundCopyJob2::GetReplyData

IBackgroundCopyJob2::SetReplyFileName