Interface IPrintAsyncNotifyDataObject (prnasnot.h)
Encapsule les données envoyées dans un canal de notification.
Héritage
L’interface IPrintAsyncNotifyDataObject hérite de l’interface IUnknown. IPrintAsyncNotifyDataObject possède également les types de membres suivants :
Méthodes
L’interface IPrintAsyncNotifyDataObject a ces méthodes.
| IPrintAsyncNotifyDataObject ::AcquireData Dirige les applications d’écoute vers les données de notification, y compris la taille et le type des données. |
| IPrintAsyncNotifyDataObject ::ReleaseData Libère la mémoire utilisée par les données encapsulées dans IPrintAsyncNotifyDataObject. |
Remarques
Les applications à l’écoute doivent appeler ReleaseData lorsqu’elles ont fini de consommer les données de notification obtenues avec AcquireData.
L’interface IPrintAsyncNotifyDataObject doit être implémentée de manière à garantir qu’un appel de IUnknown ::Release ne libère pas l’objet si une application à l’écoute n’a pas fini de consommer les données de l’objet. Par conséquent, si un appel à Release se produit lorsqu’une application a appelé AcquireData mais n’a pas encore appelé ReleaseData , l’objet ne doit pas être libéré. Pour cette raison, nous recommandons à AcquireData d’utiliser IUnknown ::AddRef pour incrémenter le nombre de références de l’objet et que ReleaseData décrémente le nombre.
Les applications d’écoute peuvent vivre dans le processus du spouleur d’impression ainsi qu’en dehors de celui-ci. Lorsque l’écouteur est en dehors de ce processus, il peut accéder uniquement aux méthodes IPrintAsyncNotifyDataObject . Par conséquent, si votre IPrintAsyncNotifyDataObject implémente également votre propre interface, sachez que les méthodes de votre interface ne sont disponibles que pour les applications à l’écoute dans le processus du spouleur d’impression.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | prnasnot.h |