Méthode IBackgroundCopyCallback1 ::OnStatus (qmgr.h)

Article
03/01/2024

[IBackgroundCopyCallback1 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.]

Implémentez la méthode OnStatus pour recevoir une notification lorsque le groupe est terminé ou qu’une erreur se produit.

Syntaxe

HRESULT OnStatus(
  [in] IBackgroundCopyGroup *pGroup,
  [in] IBackgroundCopyJob1  *pJob,
  [in] DWORD                dwFileIndex,
  [in] DWORD                dwStatus,
  [in] DWORD                dwNumOfRetries,
  [in] DWORD                dwWin32Result,
  [in] DWORD                dwTransportResult
);

Paramètres

[in] pGroup

Pointeur d’interface vers le groupe qui a généré l’événement.

[in] pJob

Pointeur d’interface vers le travail associé à l’événement ou NULL si l’événement n’est pas associé à un travail.

[in] dwFileIndex

Indexer le fichier associé à l’erreur ou -1. Pour récupérer le fichier, appelez la méthode IBackgroundCopyJob1 ::GetFile .

[in] dwStatus

État du groupe. L’état du groupe est terminé (tous les travaux du groupe ont été téléchargés) ou par erreur. Une erreur s’est produite si l’indicateur QM_STATUS_GROUP_ERROR est défini. Sinon, le groupe est terminé.

[in] dwNumOfRetries

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

[in] dwWin32Result

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

[in] dwTransportResult

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

Valeur retournée

Cette méthode doit retourner S_OK ; sinon, le service continue d’appeler cette méthode jusqu’à ce que S_OK soit retourné. L’intervalle auquel l’implémentation est appelée est arbitraire.

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

Voir aussi

IBackgroundCopyCallback1

Partager via