Metodo IActionProgress::UpdateProgress (shobjidl_core.h)

Aggiornamenti lo stato di avanzamento di un'azione nell'interfaccia utente.

Sintassi

HRESULT UpdateProgress(
  [in] ULONGLONG ulCompleted,
  [in] ULONGLONG ulTotal
);

Parametri

[in] ulCompleted

Tipo: ULONGLONG

Quantità dell'azione completata.

[in] ulTotal

Tipo: ULONGLONG

Quantità totale dell'azione.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o un valore di errore in caso contrario.

Commenti

Questo metodo deve essere chiamato periodicamente per aggiornare lo stato di avanzamento dell'azione. La classe di implementazione può interpretare questi valori in qualsiasi modo desiderati, anche se i valori di ulCompleted e ulTotal devono essere interpretati l'uno rispetto all'altro per determinare una quantità significativa di avanzamento. Spesso è desiderata una percentuale, nel qual caso il valore di ulCompleted deve essere diviso per ulTotal e il risultato moltiplicato per un valore pari a 100.

Requisiti