Método IFileOperationProgressSink::UpdateProgress (shobjidl_core.h)

Proporciona una estimación de la cantidad total de trabajo realizado actualmente en relación con la cantidad total de trabajo.

Sintaxis

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

Parámetros

[in] iWorkTotal

Tipo: UINT

Una estimación de la cantidad de trabajo que se va a completar.

[in] iWorkSoFar

Tipo: UINT

La parte de iWorkTotal que se ha completado hasta ahora.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Los valores de iWorkTotal e iWorkSoFar son "puntos" o estimaciones de la cantidad de trabajo que se va a realizar y cuánto se ha completado. No se especifican en ninguna unidad determinada, pero deben ser aproximadamente proporcionales al tiempo que tarda el proceso total. Por ejemplo, para copiar un archivo pequeño podría considerarse dos puntos y un archivo grande podría considerarse diez puntos. Si un proceso realiza una operación que copia cinco archivos pequeños y un archivo grande, y el proceso ha completado cuatro de los archivos pequeños, iWorkSoFar sería ocho puntos (4 x 2 = 8) y iWorkTotal sería veinte puntos (5 x 2 + 10 = 20), por lo que la estimación sería 8 de 20 puntos (o 40%) completado.

Requisitos