Méthode IBackgroundCopyGroup ::GetProgress (qmgr.h)

Article
03/01/2024

[IBackgroundCopyGroup est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt les interfaces BITS.]

Utilisez la méthode GetProgress pour récupérer la progression du téléchargement.

Syntaxe

HRESULT GetProgress(
  [in]  DWORD dwFlags,
  [out] DWORD *pdwProgress
);

Paramètres

[in] dwFlags

Type de progression à récupérer. Spécifiez l’un des indicateurs suivants.

Valeur	Signification
QM_PROGRESS_PERCENT_DONE	Retourne le pourcentage du téléchargement terminé.
QM_PROGRESS_SIZE_DONE	Retourne le nombre d’octets téléchargés.
QM_PROGRESS_TIME_DONE	Non pris en charge.

[out] pdwProgress

Progression du téléchargement. La progression représente le nombre d’octets téléchargés ou le pourcentage du téléchargement terminé, selon dwFlags.

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour	Description
S_OK	Récupération réussie de la progression du groupe.
E_NOTIMPL	Vous ne pouvez pas spécifier QM_PROGRESS_TIME_DONE pour le paramètre dwFlags .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
Plateforme cible	Windows
En-tête	qmgr.h
DLL	QmgrPrxy.dll

Voir aussi

IBackgroundCopyGroup

Partager via