struktur BG_FILE_INFO (bits.h)

Artikel
02/23/2024

Menyediakan nama lokal dan jarak jauh dari file yang akan ditransfer.

Sintaks

typedef struct _BG_FILE_INFO {
  LPWSTR RemoteName;
  LPWSTR LocalName;
} BG_FILE_INFO;

Anggota

RemoteName

String yang dihentikan dengan null yang berisi nama file di server (misalnya, http://< server>/<path>/file.ext). Format nama harus sesuai dengan protokol transfer yang Anda gunakan. Anda tidak dapat menggunakan kartubebas dalam jalur atau nama file. URL hanya boleh berisi karakter URL hukum; tidak ada pemrosesan escape yang dilakukan. URL dibatasi hingga 2.200 karakter, tidak termasuk terminator null.

Setiap segmen URL terbatas pada MAX_PATH karakter.

Anda dapat menggunakan SMB untuk mengekspresikan nama jarak jauh file untuk diunduh atau diunggah; tidak ada dukungan SMB untuk pekerjaan balasan unggahan. Anda dapat menentukan nama jarak jauh sebagai jalur UNC, jalur lengkap dengan drive jaringan, atau menggunakan awalan "file://". BITS 1.5 dan yang lebih lama: Protokol SMB untuk RemoteName tidak didukung.

LocalName

String yang dihentikan null yang berisi nama file pada klien. Nama file harus menyertakan jalur lengkap (misalnya, d:\myapp\updates\file.ext). Anda tidak dapat menggunakan kartubebas di jalur atau nama file, dan direktori di jalur harus ada. Jalur terbatas pada MAX_PATH, tidak termasuk terminator null.

Pengguna harus memiliki izin untuk menulis ke direktori lokal untuk unduhan dan bagian balasan dari pekerjaan balasan unggahan. BITS tidak mendukung aliran NTFS. Alih-alih menggunakan drive jaringan, yang spesifik sesi, gunakan jalur UNC (misalnya, \server\share\path\file). Jangan sertakan \? awalan di jalur.

Keterangan

BITS mendukung protokol HTTP, HTTPS, dan SMB untuk RemoteName. Untuk persyaratan HTTP, lihat Persyaratan HTTP untuk Unduhan BITS.

BITS 1.5 dan yang lebih lama: Protokol SMB untuk RemoteName tidak didukung.

Berikut ini mengidentifikasi apakah BITS menyebarluaskan stempel waktu file:

Untuk unduhan HTTP, BITS menyebarkan stempel waktu modifikasi file dan mengatur waktu pembuatan file ke waktu modifikasi.
Untuk unggahan HTTP, BITS tidak menyebarluaskan stempel waktu file.
Untuk unduhan dan unggahan SMB, BITS menyebarluaskan stempel waktu file.

BITS tidak mendukung jalur SMB ke pipa atau perangkat bernama. Untuk mempertahankan informasi pemilik dan ACL untuk file yang diunduh menggunakan SMB, panggil metode IBackgroundCopyJob3::SetFileACLFlags .

Jika jalur dan bagian nama file URL untuk pekerjaan pengunggahan dan pengunggahan balasan HTTP berisi karakter Unicode yang tidak sama dengan halaman kode pada klien dan server, terjemahan URL akan gagal di server dan pekerjaan BITS akan ditempatkan dalam status kesalahan. Jika bagian server URL berisi karakter Unicode, Anda harus mengodekan bagian server menggunakan Nama Domain Internasional (IDN).

BITS tidak membatasi ukuran file yang dapat Anda unduh menggunakan HTTP. Untuk batas pengunggahan, lihat properti ekstensi IIS BITSMaximumUploadSize .

IIS 5.0: Unduhan dibatasi hingga 4 GB.

BITS 1.2 dan yang lebih lama: Untuk unduhan HTTP, ukuran file maksimum yang dapat Anda transfer adalah 4 GB; BITS tidak dapat menjamin keberhasilan transfer file lebih dari 4 GB. Jika URL berisi karakter Unicode yang tidak berada dalam kumpulan karakter US-ASCII, kodekan string Unicode di UTF-8 sebelum meneruskannya sebagai nama file jarak jauh ke BITS. Jika Anda tidak mengodekan string, server HTTP mungkin menerima URL yang salah dan pekerjaan dapat memasuki status kesalahan.