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

Mises à jour le status de progression du transfert dans l’interface utilisateur.

Syntaxe

HRESULT UpdateProgress(
  [in] ULONGLONG ullSizeCurrent,
  [in] ULONGLONG ullSizeTotal,
  [in] int       nFilesCurrent,
  [in] int       nFilesTotal,
  [in] int       nFoldersCurrent,
  [in] int       nFoldersTotal
);

Paramètres

[in] ullSizeCurrent

Type : ULONGLONG

Nombre d’octets traités dans l’opération en cours.

[in] ullSizeTotal

Type : ULONGLONG

Nombre total d’octets dans l’opération actuelle.

[in] nFilesCurrent

Type : int

Nombre de fichiers traités dans l’opération en cours.

[in] nFilesTotal

Type : int

Nombre total de fichiers dans l’opération. Définissez sur 0 pour indiquer que la valeur n’a pas changé depuis le dernier appel à cette méthode.

[in] nFoldersCurrent

Type : int

Nombre de dossiers traités dans l’opération en cours.

[in] nFoldersTotal

Type : int

Nombre total de dossiers dans l’opération. Définissez sur 0 pour indiquer que la valeur n’a pas changé depuis le dernier appel à cette méthode.

Valeur retournée

Type : HRESULT

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

Remarques

Définissez ullSizeTotal, nFilesTotal et nFoldersTotal sur 0 pour indiquer que les totaux n’ont pas changé depuis le dernier appel à cette méthode.

Définissez les six paramètres sur 0 pour indiquer que la progression n’a pas changé depuis le dernier appel à cette méthode.

Remarque à l’attention des implémenteurs

Les implémenteurs de cette fonction doivent retourner un code d’erreur lorsque l’opération doit se terminer avant d’être terminée, par exemple lorsque l’utilisateur clique sur le bouton Annuler .

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 (inclure Shobjidl.h)