Méthode IBackgroundCopyGroup ::GetStatus (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 GetStatus pour récupérer l’état du groupe.

Syntaxe

HRESULT GetStatus(
  [out] DWORD *pdwStatus,
        DWORD *pdwJobIndex
);

Paramètres

[out] pdwStatus

État du groupe. L’état peut être défini sur un ou plusieurs des indicateurs suivants.

Valeur	Signification
QM_STATUS_GROUP_FOREGROUND	QMGR télécharge le groupe au premier plan.
QM_STATUS_GROUP_INCOMPLETE	QMGR télécharge toujours le groupe.
QM_STATUS_GROUP_SUSPENDED	Le groupe est suspendu.
QM_STATUS_GROUP_ERROR	Une erreur s’est produite lors du traitement du groupe.

pdwJobIndex

Travail en cours. L’index est toujours 0 (les groupes ne peuvent contenir qu’un seul travail).

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 l’état du groupe.

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