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

Restablece el temporizador del cuadro de diálogo de progreso a cero.

Sintaxis

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

Parámetros

[in] dwTimerAction

Tipo: DWORD

Marcas que indican la acción que debe realizar el temporizador. Uno de los siguientes valores:

PDTIMER_RESET

Restablece el temporizador en cero. El progreso se calculará a partir del momento en que se llama a este método.

PDTIMER_PAUSE

Se ha suspendido el progreso.

PDTIMER_RESUME

Se ha reanudado el progreso.

pvResevered

Tipo: LPCVOID

Reservado. Se establece en NULL.

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

El temporizador se usa para calcular el tiempo restante. Se inicia cuando la aplicación llama a IProgressDialog::StartProgressDialog. A menos que la aplicación se inicie inmediatamente, debe llamar al temporizador justo antes de iniciar la operación. Esta práctica garantiza que las estimaciones de tiempo sean lo más precisas posible. No se debe llamar a este método después de la primera llamada a IProgressDialog::SetProgress.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

IProgressDialog