Metode IBackgroundCopyJob2::GetReplyData (bits1_5.h)

  • Artikel

Mengambil salinan data balasan dalam memori dari aplikasi server. Panggil metode ini hanya jika jenis pekerjaan BG_JOB_TYPE_UPLOAD_REPLY dan statusnya BG_JOB_STATE_TRANSFERRED.

Sintaks

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

Parameter

[in, out] ppBuffer

Buffer untuk berisi data balasan. Metode mengatur ppBuffer ke NULL jika aplikasi server tidak mengembalikan balasan. Panggil fungsi CoTaskMemFree untuk membebaskan ppBuffer setelah selesai.

[out] pLength

Ukuran, dalam byte, dari data balasan di ppBuffer.

Menampilkan nilai

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode Deskripsi
S_OK
 Berhasil mengambil data balasan.
BG_E_TOO_LARGE
 Data balasan melebihi ukuran buffer maksimum 1 MB. Parameter ppBuffer diatur ke NULL, dan pSize berisi ukuran data balasan.
BG_E_INVALID_STATE
 Untuk mengambil data balasan, status pekerjaan harus BG_JOB_STATE_TRANSFERRED.
E_NOTIMPL
 Metode ini tidak diimplementasikan untuk pekerjaan jenis BG_JOB_TYPE_DOWNLOAD atau BG_JOB_TYPE_UPLOAD.

Keterangan

Metode GetReplyData memungkinkan Anda membaca data balasan sebelum atau sesudah Anda memanggil metode IBackgroundCopyJob::Complete . Namun, untuk membaca data balasan dari file balasan, Anda harus terlebih dahulu memanggil metode Lengkap ; file tidak tersedia untuk klien sampai Anda memanggil metode Lengkap .

Metode GetReplyData mengembalikan BG_E_TOO_LARGE jika data balasan melebihi 1 MB (pSize berisi ukuran data balasan). Untuk mengambil balasan jika melebihi 1 MB, panggil metode IBackgroundCopyJob2::GetReplyFileName untuk mengambil nama file. Kemudian, buka file dan baca data balasan secara langsung.

Contoh

Untuk contoh yang menggunakan metode GetReplyData , lihat Mengambil Balasan Dari Pekerjaan Upload-Reply.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Server minimum yang didukung Windows Server 2003
Target Platform Windows
Header bits1_5.h (termasuk Bits.h)
Pustaka Bits.lib
DLL BitsPrx2.dll
Redistribusi BITS 1.5 di Windows XP

Lihat juga

IBackgroundCopyJob2::GetReplyFileName

IBackgroundCopyJob2::SetReplyFileName