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

Réinitialise le minuteur de boîte de dialogue de progression à zéro.

Syntaxe

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

Paramètres

[in] dwTimerAction

Type : DWORD

Indicateurs qui indiquent l’action à entreprendre par le minuteur. Une des valeurs suivantes :

PDTIMER_RESET

Réinitialise le minuteur à zéro. La progression est calculée à partir du moment où cette méthode est appelée.

PDTIMER_PAUSE

La progression a été suspendue.

PDTIMER_RESUME

Les progrès ont repris.

pvResevered

Type : LPCVOID

Réservé. Défini sur NULL.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le minuteur est utilisé pour estimer le temps restant. Il est démarré lorsque votre application appelle IProgressDialog ::StartProgressDialog. À moins que votre application ne démarre immédiatement, elle doit appeler Minuteur juste avant de démarrer l’opération. Cette pratique garantit que les estimations de temps seront aussi précises que possible. Cette méthode ne doit pas être appelée après le premier appel à IProgressDialog ::SetProgress.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h
DLL Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

IProgressDialog