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

Atualizações o progresso de uma ação para a interface do usuário.

Sintaxe

HRESULT UpdateProgress(
  [in] ULONGLONG ulCompleted,
  [in] ULONGLONG ulTotal
);

Parâmetros

[in] ulCompleted

Tipo: ULONGLONG

A quantidade da ação concluída.

[in] ulTotal

Tipo: ULONGLONG

A quantidade total da ação.

Retornar valor

Tipo: HRESULT

Retorne S_OK se tiver êxito ou um valor de erro, caso contrário.

Comentários

Esse método deve ser chamado periodicamente para atualizar o progresso da ação. A classe de implementação pode interpretar esses valores de qualquer maneira desejada, embora os valores de ulCompleted e ulTotal devem ser interpretados em relação uns aos outros para determinar um valor de progresso significativo. Geralmente, é desejado um percentual, nesse caso, o valor de ulCompleted deve ser dividido por ulTotal e o resultado multiplicado por um valor de 100.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shobjidl.idl