Condividi tramite


Metodo IProgressDialog::Timer (shlobj_core.h)

Reimposta il timer della finestra di dialogo di avanzamento su zero.

Sintassi

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

Parametri

[in] dwTimerAction

Tipo: DWORD

Flag che indicano l'azione da eseguire dal timer. Uno dei valori seguenti:

PDTIMER_RESET

Reimposta il timer su zero. Lo stato di avanzamento verrà calcolato dal momento in cui viene chiamato questo metodo.

PDTIMER_PAUSE

Lo stato di avanzamento è stato sospeso.

PDTIMER_RESUME

Lo stato di avanzamento è stato ripreso.

pvResevered

Tipo: LPCVOID

Riservato. Impostare su NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il timer viene usato per stimare il tempo rimanente. Viene avviato quando l'applicazione chiama IProgressDialog::StartProgressDialog. A meno che l'applicazione non inizierà immediatamente, deve chiamare Timer appena prima di avviare l'operazione. Questa pratica garantisce che le stime temporali saranno più accurate possibile. Questo metodo non deve essere chiamato dopo la prima chiamata a IProgressDialog::SetProgress.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h
DLL Shell32.dll (versione 5.0 o successiva)

Vedi anche

IProgressDialog