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

Article
03/04/2024

Mises à jour la progression d’une action dans l’interface utilisateur.

Syntaxe

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

Paramètres

[in] ulCompleted

Type : ULONGLONG

Quantité de l’action terminée.

[in] ulTotal

Type : ULONGLONG

Montant total de l’action.

Valeur retournée

Type : HRESULT

Retournez S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire.

Remarques

Cette méthode doit être appelée régulièrement pour mettre à jour la progression de l’action. La classe d’implémentation peut interpréter ces valeurs de la manière souhaitée, bien que les valeurs de ulCompleted et ulTotal doivent être interprétées les unes par rapport aux autres pour déterminer une progression significative. Souvent, un pourcentage est souhaité, auquel cas la valeur de ulCompleted doit être divisée par ulTotal, et le résultat multiplié par une valeur de 100.

Configuration requise

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

Partager via