Metodo IFileOperationProgressSink::UpdateProgress (shobjidl_core.h)

Articolo
03/02/2024

Fornisce una stima della quantità totale di lavoro attualmente eseguita in relazione alla quantità totale di lavoro.

Sintassi

HRESULT UpdateProgress(
  [in] UINT iWorkTotal,
  [in] UINT iWorkSoFar
);

Parametri

[in] iWorkTotal

Tipo: UINT

Stima della quantità di lavoro da completare.

[in] iWorkSoFar

Tipo: UINT

Parte di iWorkTotal completata finora.

Valore restituito

Tipo: HRESULT

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

Commenti

I valori iWorkTotal e iWorkSoFar sono "punti" o stime della quantità di lavoro da eseguire e la quantità di completamento. Non vengono specificate in alcuna unità specifica, ma devono essere proporzionali approssimativamente al tempo impiegato dal processo totale. Ad esempio, per copiare un file di piccole dimensioni può essere considerato due punti e un file di grandi dimensioni può essere considerato dieci punti. Se un processo esegue un'operazione che copia cinque file di piccole dimensioni e un file di grandi dimensioni e il processo ha completato quattro dei file di piccole dimensioni, iWorkSoFar sarà di otto punti (4 x 2 = 8) e iWorkTotal sarà di venti punti (5 x 2 + 10 = 20), quindi la stima sarà 8 di 20 punti (o 40%) completati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite