Metode IFileOperationProgressSink::UpdateProgress (shobjidl_core.h)

Artikel
03/02/2024

Memberikan perkiraan jumlah total pekerjaan yang saat ini dilakukan sehubungan dengan jumlah total pekerjaan.

Sintaks

HRESULT UpdateProgress(
  [in] UINT iWorkTotal,
  [in] UINT iWorkSoFar
);

Parameter

[in] iWorkTotal

Jenis: UINT

Perkiraan jumlah pekerjaan yang akan diselesaikan.

[in] iWorkSoFar

Jenis: UINT

Bagian iWorkTotal yang telah selesai sejauh ini.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Nilai iWorkTotal dan iWorkSoFar adalah "poin" atau perkiraan jumlah pekerjaan yang harus dilakukan, dan berapa banyak yang diselesaikan. Mereka tidak ditentukan dalam unit tertentu, tetapi harus kira-kira sebanding dengan berapa banyak waktu yang dibutuhkan proses total. Misalnya, untuk menyalin satu file kecil mungkin dianggap sebagai dua poin, dan file besar mungkin dianggap sepuluh poin. Jika proses melakukan operasi yang menyalin lima file kecil dan satu file besar, dan prosesnya telah menyelesaikan empat file kecil, iWorkSoFar akan menjadi delapan poin (4 x 2 = 8) dan iWorkTotal akan menjadi dua puluh poin (5 x 2 + 10 = 20), sehingga perkiraannya adalah 8 dari 20 poin (atau 40%) selesai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui