Metode IBackgroundCopyJob2::SetReplyFileName (bits1_5.h)

  • Artikel

Menentukan nama file untuk memuat data balasan dari aplikasi server. Panggil metode ini hanya jika jenis pekerjaan BG_JOB_TYPE_UPLOAD_REPLY.

Sintaks

HRESULT SetReplyFileName(
  [in] LPCWSTR ReplyFileName
);

Parameter

[in] ReplyFileName

String yang dihentikan null yang berisi jalur lengkap ke file balasan. BITS menghasilkan nama file jika ReplyFileNamePathSpec adalah NULL atau string kosong. Anda tidak dapat menggunakan kartubebas di jalur atau nama file, dan direktori di jalur harus ada. Jalur ini terbatas pada MAX_PATH, tidak termasuk terminator null. Pengguna harus memiliki izin untuk menulis ke direktori. BITS tidak mendukung aliran NTFS. Alih-alih menggunakan drive jaringan, yang spesifik untuk sesi, gunakan jalur UNC (misalnya, \server\share\path\file). Jangan sertakan \? awalan di jalur.

Nilai kembali

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode Deskripsi
S_OK
 Berhasil menentukan nama file untuk memuat data balasan.
BG_E_INVALID_STATE
 Anda tidak dapat mengubah nama file balasan setelah BITS mulai mentransfer balasan ke klien. BITS mentransfer balasan ke klien jika statusnya BG_JOB_STATE_TRANSFERRING dan anggota BytesTotal dari struktur BG_JOB_REPLY_PROGRESS tidak BG_SIZE_UNKNOWN.
E_ACCESSDENIED
 Pengguna tidak memiliki izin untuk menulis ke direktori yang ditentukan pada klien.
E_INVALIDARG
 Nama file balasan tidak valid atau melebihi MAX_PATH.

Keterangan

BITS menghasilkan nama file jika Anda tidak memanggil metode SetReplyFileName sebelum memanggil metode IBackgroundCopyJob::Resume untuk pertama kalinya.

Jika BITS menghasilkan nama file, file balasan ditulis ke direktori yang sama dengan file unggahan lokal.

Anda dapat memanggil metode SetReplyFileName kapan saja sebelum BITS mulai mengunduh balasan dari aplikasi server; metode gagal jika unduhan telah dimulai.

File balasan tersedia untuk klien setelah memanggil metode IBackgroundCopyJob::Complete . Untuk mengambil data balasan sebelum memanggil metode Lengkap , panggil metode IBackgroundCopyJob2::GetReplyData .

File kosong jika aplikasi server tidak memberikan balasan.

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

IBackgroundCopyJob::GetReplyData

IBackgroundCopyJob::GetReplyFileName