Méthode IPrintAsyncNotifyDataObject::AcquireData (prnasnot.h)

Dirige les applications d’écoute vers les données de notification, y compris la taille et le type des données.

Syntaxe

HRESULT AcquireData(
  [out] BYTE                       **ppNotificationData,
  [out] ULONG                      *pSize,
  [out] PrintAsyncNotificationType **ppSchema
);

Paramètres

[out] ppNotificationData

Mémoire tampon contenant les données de notification.

[out] pSize

Taille de la mémoire tampon de données.

[out] ppSchema

Pointeur GUID vers le schéma de données.

Valeur retournée

Pour connaître les valeurs possibles , consultez PrintAsyncNotifyError .

Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs.

Notes

Les applications qui appellent cette méthode doivent appeler ReleaseData lorsqu’elles ont fini de consommer les données de notification.

L’interface IPrintAsyncNotifyDataObject doit être implémentée pour garantir qu’un appel de IUnknown::Release ne libère pas l’objet si une application d’é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.

Lorsque le spouleur d’impression échoue, il crée un objet IPrintAsyncNotifyDataObject . Lorsqu’un écouteur appelle AcquireData pour cette notification, ppNotificationData a la valeur NULL, la taille est 0 et ppSchema est NOTIFICATION_RELEASE.

Spécifications

Voir aussi

Interfaces de notification d’impression asynchrone

IPrintAsyncNotifyDataObject

Impression