Méthode IFileOperationProgressSink ::UpdateProgress (shobjidl_core.h)

Article
03/02/2024

Fournit une estimation de la quantité totale de travail actuellement effectuée par rapport à la quantité totale de travail.

Syntaxe

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

Paramètres

[in] iWorkTotal

Type : UINT

Estimation de la quantité de travail à accomplir.

[in] iWorkSoFar

Type : UINT

Partie d’iWorkTotal qui a été terminée jusqu’à présent.

Valeur retournée

Type : HRESULT

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

Remarques

Les valeurs iWorkTotal et iWorkSoFar sont des « points » ou des estimations de la quantité de travail à effectuer et de la quantité terminée. Ils ne sont pas spécifiés dans des unités particulières, mais doivent être à peu près proportionnels à la durée totale du processus. Par exemple, pour copier un petit fichier peut être considéré comme deux points, et un fichier volumineux peut être considéré comme dix points. Si un processus effectue une opération qui copie cinq petits fichiers et un fichier volumineux, et que le processus a terminé quatre des petits fichiers, iWorkSoFar serait huit points (4 x 2 = 8) et iWorkTotal aurait vingt points (5 x 2 + 10 = 20), de sorte que l’estimation serait de 8 points sur 20 (ou 40 %).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)

Partager via