Metode ITransferAdviseSink::UpdateProgress (shobjidl_core.h)

Updates status kemajuan transfer di UI.

Sintaks

HRESULT UpdateProgress(
  [in] ULONGLONG ullSizeCurrent,
  [in] ULONGLONG ullSizeTotal,
  [in] int       nFilesCurrent,
  [in] int       nFilesTotal,
  [in] int       nFoldersCurrent,
  [in] int       nFoldersTotal
);

Parameter

[in] ullSizeCurrent

Jenis: ULONGLONG

Jumlah byte yang diproses dalam operasi saat ini.

[in] ullSizeTotal

Jenis: ULONGLONG

Jumlah total byte dalam operasi saat ini.

[in] nFilesCurrent

Jenis: int

Jumlah file yang diproses dalam operasi saat ini.

[in] nFilesTotal

Jenis: int

Jumlah total file dalam operasi. Atur ke 0 untuk menunjukkan bahwa nilai tidak berubah sejak panggilan terakhir ke metode ini.

[in] nFoldersCurrent

Jenis: int

Jumlah folder yang diproses dalam operasi saat ini.

[in] nFoldersTotal

Jenis: int

Jumlah total folder dalam operasi. Atur ke 0 untuk menunjukkan bahwa nilai tidak berubah sejak panggilan terakhir ke metode ini.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Atur ullSizeTotal, nFilesTotal, dan nFoldersTotal semua ke 0 untuk menunjukkan bahwa total tidak berubah sejak panggilan terakhir ke metode ini.

Atur keenam parameter ke 0 untuk menunjukkan bahwa kemajuan tidak berubah sejak panggilan terakhir ke metode ini.

Catatan untuk Pelaksana

Pelaksana fungsi ini harus mengembalikan kode kesalahan ketika operasi perlu dihentikan sebelum selesai, seperti ketika pengguna mengklik tombol Batal .

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)