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

Fornece uma estimativa da quantidade total de trabalho atualmente feita em relação à quantidade total de trabalho.

Sintaxe

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

Parâmetros

[in] iWorkTotal

Tipo: UINT

Uma estimativa da quantidade de trabalho a ser concluída.

[in] iWorkSoFar

Tipo: UINT

A parte do iWorkTotal que foi concluída até agora.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os valores iWorkTotal e iWorkSoFar são "pontos" ou estimativas da quantidade de trabalho a ser feita e quanto é concluído. Elas não são especificadas em nenhuma unidade específica, mas devem ser aproximadamente proporcionais a quanto tempo o processo total leva. Por exemplo, copiar um arquivo pequeno pode ser considerado dois pontos e um arquivo grande pode ser considerado dez pontos. Se um processo estiver executando uma operação que copia cinco arquivos pequenos e um arquivo grande e o processo tiver concluído quatro dos arquivos pequenos, iWorkSoFar seria de oito pontos (4 x 2 = 8) e iWorkTotal seria de vinte pontos (5 x 2 + 10 = 20), portanto, a estimativa seria de 8 de 20 pontos (ou 40%) concluída.

Requisitos