IActionProgress::UpdateProgress 方法 (shobjidl_core.h)
匯報 UI 動作的進度。
語法
HRESULT UpdateProgress(
[in] ULONGLONG ulCompleted,
[in] ULONGLONG ulTotal
);
參數
[in] ulCompleted
類型: ULONGLONG
動作完成的數量。
[in] ulTotal
類型: ULONGLONG
動作的總數量。
傳回值
類型: HRESULT
如果成功,則傳回S_OK,否則傳回錯誤值。
備註
應該定期呼叫這個方法,以更新動作的進度。 實作類別可能會以任何方式解譯這些值,不過 ulCompleted 和 ulTotal 的值應該彼此解譯,以判斷有意義的進度量。 通常,需要百分比,在此情況下 ,ulCompleted 的值應該除以 ulTotal,而結果乘以 100 的值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |
Dll | Shobjidl.idl |