共用方式為

IFileOperationProgressSink：：UpdateProgress 方法 (shobjidl_core.h)

  • 發行項

提供目前與總工時量相關的總工時量估計值。

語法

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

參數

[in] iWorkTotal

類型： UINT

估計要完成的工作量。

[in] iWorkSoFar

類型： UINT

到目前為止已完成的 iWorkTotal 部分。

傳回值

類型： HRESULT

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

備註

iWorkTotal 和 iWorkSoFar 值是「點」或預估要完成的工作量，以及完成多少。 它們未以任何特定單位指定，但應該大致與總程式花費的時間成正比。 例如，若要複製一個小檔案可能會被視為兩點，而大型檔案可能會被視為十點。 如果進程正在執行複製五個小檔案和一個大型檔案的作業， 而且此程式已完成四個小檔案， iWorkSoFar 會是 8 點 (4 x 2 = 8) ， 而 iWorkTotal 會是 20 點 (5 x 2 + 10 = 20) ，因此估計值為 20 點 (或 40%) 完成。

規格需求

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