Partager via

Interface IBackgroundCopyCallback1 (qmgr.h)

  • Article

[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 l’interface IBackgroundCopyCallback1 pour recevoir une notification lorsque des événements se produisent. Les applications utilisent cette interface comme option pour interroger l’état du groupe.

Pour recevoir des notifications, appelez la méthode IBackgroundCopyGroup::SetProp pour définir les propriétés GROUPPROP_NOTIFYCLSID et GROUPPROP_NOTIFYFLAGS .

QMGR utilise le pointeur d’interface lorsqu’il est valide (le pointeur d’interface devient non valide lorsque votre application se ferme). Lorsque votre application redémarre, vous devez réinitialiser la propriété GROUPPROP_NOTIFYCLSID sur les groupes que QMGR traite toujours.

Note QMGR active le nouvel objet dans l’étendue du processus client ; les notifications ne sont pas exécutées dans leur propre processus. QMGR crée un nouvel objet de ce CLSID et passe un pointeur d’interface vers BITS.
 
Vous devez implémenter toutes les méthodes de l’interface IBackgroundCopyCallback1 . Au minimum, la méthode doit retourner S_OK. Pour réduire le risque que votre rappel bloque bits, gardez votre implémentation courte.

Si un administrateur prend possession du groupe, les rappels de notification sont effectués dans le contexte de l’utilisateur qui a demandé la notification.

Héritage

L’interface IBackgroundCopyCallback1 hérite de l’interface IUnknown . IBackgroundCopyCallback1 a également les types de membres suivants :

Méthodes

L’interface IBackgroundCopyCallback1 possède ces méthodes.

 
IBackgroundCopyCallback1::OnStatus

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

Spécifications

   
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
Plateforme cible Windows
En-tête qmgr.h