IBackgroundCopyJob2::GetReplyFileName 메서드(bits1_5.h)
서버 애플리케이션에서 회신 데이터가 포함된 파일의 이름을 검색합니다. 작업 유형이 BG_JOB_TYPE_UPLOAD_REPLY 경우에만 이 메서드를 호출합니다.
구문
HRESULT GetReplyFileName(
[out] LPWSTR *pReplyFileName
);
매개 변수
[out] pReplyFileName
회신 파일의 전체 경로를 포함하는 Null로 끝나는 문자열입니다. 완료되면 CoTaskMemFree 함수를 호출하여 pReplyFileName을 해제합니다.
반환 값
이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
회신 데이터가 포함된 파일의 이름을 성공적으로 검색했습니다. |
|
이 메서드는 형식 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 |