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 |