Método IProgressDialog::Timer (shlobj_core.h)

Redefine o temporizador da caixa de diálogo de progresso como zero.

Sintaxe

HRESULT Timer(
  [in] DWORD   dwTimerAction,
       LPCVOID pvResevered
);

Parâmetros

[in] dwTimerAction

Tipo: DWORD

Sinalizadores que indicam a ação a ser executada pelo temporizador. Um dos seguintes valores:

PDTIMER_RESET

Redefine o temporizador para zero. O progresso será calculado a partir do momento em que esse método for chamado.

PDTIMER_PAUSE

O progresso foi suspenso.

PDTIMER_RESUME

O progresso foi retomado.

pvResevered

Tipo: LPCVOID

Reservado. Defina como NULL.

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

O temporizador é usado para estimar o tempo restante. Ele é iniciado quando seu aplicativo chama IProgressDialog::StartProgressDialog. A menos que seu aplicativo seja iniciado imediatamente, ele deve chamar Timer pouco antes de iniciar a operação. Essa prática garante que as estimativas de tempo sejam as mais precisas possíveis. Esse método não deve ser chamado após a primeira chamada para IProgressDialog::SetProgress.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, 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	shlobj_core.h
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

IProgressDialog