다음을 통해 공유

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

  • 아티클

서버 애플리케이션에서 회신 데이터의 메모리 내 복사본을 검색합니다. 작업의 형식이 BG_JOB_TYPE_UPLOAD_REPLY 상태가 BG_JOB_STATE_TRANSFERRED 경우에만 이 메서드를 호출합니다.

구문

HRESULT GetReplyData(
  [in, out] byte   **ppBuffer,
  [out]     UINT64 *pLength
);

매개 변수

[in, out] ppBuffer

회신 데이터를 포함할 버퍼입니다. 서버 애플리케이션이 회신을 반환하지 않은 경우 메서드는 ppBuffer 를 NULL 로 설정합니다. 완료되면 CoTaskMemFree 함수를 호출하여 ppBuffer를 해제합니다.

[out] pLength

ppBuffer의 회신 데이터의 크기(바이트)입니다.

반환 값

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

반환 코드 설명
S_OK
 회신 데이터를 성공적으로 검색했습니다.
BG_E_TOO_LARGE
 회신 데이터가 최대 1MB 버퍼 크기를 초과합니다. ppBuffer 매개 변수는 NULL로 설정되고 pSize에는 회신 데이터의 크기가 포함됩니다.
BG_E_INVALID_STATE
 회신 데이터를 검색하려면 작업의 상태를 BG_JOB_STATE_TRANSFERRED 합니다.
E_NOTIMPL
 이 메서드는 형식 BG_JOB_TYPE_DOWNLOAD 또는BG_JOB_TYPE_UPLOAD 작업에 대해 구현되지 않습니다.

설명

GetReplyData 메서드를 사용하면 IBackgroundCopyJob::Complete 메서드를 호출하기 전이나 후에 회신 데이터를 읽을 수 있습니다. 그러나 회신 파일에서 회신 데이터를 읽으려면 먼저 Complete 메서드를 호출해야 합니다. Complete 메서드를 호출할 때까지 클라이언트에서 파일을 사용할 수 없습니다.

GetReplyData 메서드는 회신 데이터가 1MB를 초과하는 경우 BG_E_TOO_LARGE 반환합니다(pSize에는 회신 데이터의 크기 포함). 회신이 1MB를 초과하는 경우 회신을 검색하려면 IBackgroundCopyJob2::GetReplyFileName 메서드를 호출하여 파일 이름을 검색합니다. 그런 다음 파일을 열고 회신 데이터를 직접 읽습니다.

예제

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

요구 사항

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

추가 정보

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName