Méthode IBackgroundCopyJob1 ::GetStatus (qmgr.h)

Article
03/01/2024

[IBackgroundCopyJob1 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 travail.

Syntaxe

HRESULT GetStatus(
  [out] DWORD *pdwStatus,
  [out] DWORD *pdwWin32Result,
  [out] DWORD *pdwTransportResult,
  [out] DWORD *pdwNumOfRetries
);

Paramètres

[out] pdwStatus

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

Valeur	Signification
QM_STATUS_JOB_FOREGROUND	Non pris en charge.
QM_STATUS_JOB_INCOMPLETE	QMGR télécharge toujours le travail.
QM_STATUS_JOB_COMPLETE	Le travail est terminé.
QM_STATUS_JOB_ERROR	Une erreur s’est produite lors du traitement du travail.

[out] pdwWin32Result

Code d’erreur Win32. Valide uniquement si l’indicateur dwStatus QM_STATUS_JOB_ERROR est défini.

[out] pdwTransportResult

Code d'erreur HTTP. Valide uniquement si l’indicateur dwStatus QM_STATUS_JOB_ERROR est défini.

[out] pdwNumOfRetries

Nombre de fois que QMGR a tenté de télécharger le travail après qu’une erreur s’est produite. Valide uniquement si l’indicateur dwStatus QM_STATUS_GROUP_ERROR est défini.

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 travail.

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

IBackgroundCopyJob1

Partager via