Metode IBackgroundCopyFile3::GetTemporaryName (bits3_0.h)
Mendapatkan jalur lengkap file sementara yang berisi konten unduhan.
Sintaks
HRESULT GetTemporaryName(
[out] LPWSTR *pFilename
);
Parameter
[out] pFilename
String yang dihentikan null yang berisi jalur lengkap file sementara. Panggil fungsi CoTaskMemFree untuk membebaskan ppFileName setelah selesai.
Nilai kembali
Metode mengembalikan nilai pengembalian berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil |
Keterangan
Aplikasi dapat menggunakan metode ini untuk mendapatkan akses ke data sebelum pekerjaan selesai. Buka file untuk akses tulis bersama (FILE_SHARE_WRITE). Untuk menentukan berapa banyak byte yang telah ditransfer dan tersedia untuk dibaca, panggil metode IBackgroundCopyFile::GetProgress . Perhatikan bahwa informasi kemajuan akan diatur kembali ke nol jika stempel waktu URL berubah.
Jangan buka file untuk dibaca sampai BITS mulai mentransfer file; jika tidak, pekerjaan akan masuk ke status kesalahan sementara.
File sementara tersedia hingga aplikasi memanggil metode IBackgroundCopyJob::Complete atau IBackgroundCopyJob::Cancel , atau kebijakan grup JobInactivityTimeout kedaluwarsa. Anda harus melepaskan handel Anda ke file sementara sebelum memanggil metode Selesai atau Batal .
ACL untuk file sementara sama dengan file akhir ketika Selesai dipanggil (ACL diwarisi dari folder).
Untuk menentukan apakah BITS selesai mentransfer file, Anda dapat:
- Panggil metode IBackgroundCopyFile::GetProgress dan bandingkan BytesTransferred to BytesTotal.
- Terapkan panggilan balik IBackgroundCopyCallback2::FileTransferred .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Windows |
Header | bits3_0.h (termasuk Bits.h) |
Pustaka | Bits.lib |