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 값과 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
회신 데이터를 성공적으로 검색했습니다. |
|
회신 데이터가 최대 1MB 버퍼 크기를 초과합니다. ppBuffer 매개 변수는 NULL로 설정되고 pSize에는 회신 데이터의 크기가 포함됩니다. |
|
회신 데이터를 검색하려면 작업의 상태를 BG_JOB_STATE_TRANSFERRED 합니다. |
|
이 메서드는 형식 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 |