IActionProgress::UpdateProgress method (shobjidl_core.h)
Updates the progress of an action to the UI.
Syntax
HRESULT UpdateProgress(
[in] ULONGLONG ulCompleted,
[in] ULONGLONG ulTotal
);
Parameters
[in] ulCompleted
Type: ULONGLONG
The amount of the action completed.
[in] ulTotal
Type: ULONGLONG
The total amount of the action.
Return value
Type: HRESULT
Return S_OK if successful, or an error value otherwise.
Remarks
This method should be called periodically to update the progress of the action. The implementing class may interpret these values in any way desired, although the values of ulCompleted and ulTotal should be interpreted relative to one another to determine a meaningful progress amount. Often, a percentage is desired, in which case the value of ulCompleted should be divided by ulTotal, and the result multiplied by a value of 100.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | shobjidl_core.h (include Shobjidl.h) |
DLL | Shobjidl.idl |