ITransferAdviseSink：：UpdateProgress 方法 (shobjidl_core.h)

匯報 UI 中的傳輸進度狀態。

語法

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

參數

[in] ullSizeCurrent

類型： ULONGLONG

目前作業中處理的位元組數目。

[in] ullSizeTotal

類型： ULONGLONG

目前作業中的位元組總數。

[in] nFilesCurrent

類型： int

目前作業中處理的檔案數目。

[in] nFilesTotal

類型： int

作業中的檔案總數。 設定為 0，表示自上次呼叫此方法之後的值尚未變更。

[in] nFoldersCurrent

類型： int

目前作業中處理的資料夾數目。

[in] nFoldersTotal

類型： int

作業中的資料夾總數。 設定為 0，表示自上次呼叫此方法之後的值尚未變更。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

將 ullSizeTotal、 nFilesTotal 和 nFoldersTotal 全部設定為 0，表示自上次呼叫此方法之後尚未變更總計。

將所有六個參數設定為 0，表示自從上次呼叫此方法之後，進度尚未變更。

實作者的注意事項

此函式的實作者應該會在作業完成之前需要終止時傳回錯誤碼，例如當使用者按兩下 [ 取消 ] 按鈕時。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)