Metode IBackgroundCopyJob2::GetReplyData (bits1_5.h)
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 |
---|---|
|
Berhasil mengambil data balasan. |
|
Data balasan melebihi ukuran buffer maksimum 1 MB. Parameter ppBuffer diatur ke NULL, dan pSize berisi ukuran data balasan. |
|
Untuk mengambil data balasan, status pekerjaan harus BG_JOB_STATE_TRANSFERRED. |
|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk