Bagikan melalui

Metode IBackgroundCopyFile3::GetTemporaryName (bits3_0.h)

  • Artikel

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
S_OK
 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:

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

Lihat juga

IBackgroundCopyCallback2::FileTransferred

IBackgroundCopyFile3