IBackgroundCopyJob::Metode lengkap

Mengakhiri pekerjaan dan menyimpan file yang ditransfer pada klien.

Sintaks

HRESULT Complete();

Parameter

Metode ini tidak memiliki parameter.

Menampilkan nilai

Metode ini mengembalikan nilai HRESULT berikut. Metode ini juga dapat mengembalikan kesalahan yang terkait dengan mengganti nama salinan sementara file yang ditransfer ke nama yang diberikan.

Menampilkan kode	Deskripsi
S_OK	Semua file berhasil ditransfer.
DO_E_INVALID_STATE	Untuk unduhan, status pekerjaan tidak dapat BG_JOB_STATE_CANCELLED atau BG_JOB_STATE_ACKNOWLEDGED. Untuk unggahan, status pekerjaan harus BG_JOB_STATE_TRANSFERRED.

Keterangan

Semua file telah berhasil ditransfer jika status pekerjaan BG_JOB_STATE_TRANSFERRED. Untuk memeriksa status pekerjaan, panggil metode IBackgroundCopyJob::GetState . Anda juga dapat menerapkan antarmuka IBackgroundCopyCallback untuk menerima pemberitahuan ketika semua file telah ditransfer ke klien.

Pengoptimalan Pengiriman mempertahankan pekerjaan yang hanya kurang dari 30 hari. Semua pekerjaan lama akan dihapus. Pengoptimalan Pengiriman tidak mendukung Kebijakan Grup JobInactivityTimeout.

Untuk pekerjaan pengunduhan, Anda dapat memanggil metode Lengkap kapan saja selama proses transfer; namun, hanya file yang berhasil ditransfer ke klien sebelum memanggil metode ini yang disimpan. Misalnya, jika Anda memanggil metode Lengkap saat Pengoptimalan Pengiriman memproses yang ketiga dari lima file, hanya dua file pertama yang disimpan. Untuk menentukan file mana yang telah ditransfer, panggil metode IBackgroundCopyFile::GetProgress dan bandingkan anggota BytesTransferred dengan anggota BytesTotal dari struktur BG_FILE_PROGRESS .

Untuk pekerjaan unggah, Anda dapat memanggil metode Lengkap hanya saat status pekerjaan BG_JOB_STATE_TRANSFERRED.

Pemilik file adalah pengguna yang melakukan panggilan. Misalnya, jika administrator menyelesaikan pekerjaan orang lain, administrator bukan pemilik pekerjaan yang memiliki file tersebut.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server, versi 1709 [hanya aplikasi desktop]
Header	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Pustaka	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyJob didefinisikan sebagai 37668D37-507E-4160-9316-26306D150B12

Lihat juga

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::GetState