IPrintAsyncNotifyDataObject-Schnittstelle (prnasnot.h)
Kapselt die in einem Benachrichtigungskanal gesendeten Daten.
Vererbung
Die IPrintAsyncNotifyDataObject-Schnittstelle erbt von der IUnknown-Schnittstelle . IPrintAsyncNotifyDataObject verfügt auch über folgende Membertypen:
Methoden
Die IPrintAsyncNotifyDataObject-Schnittstelle verfügt über diese Methoden.
| IPrintAsyncNotifyDataObject::AcquireData Leitet lauschende Anwendungen an die Benachrichtigungsdaten weiter, einschließlich der Größe und des Typs der Daten. |
| IPrintAsyncNotifyDataObject::ReleaseData Gibt den Arbeitsspeicher frei, der von den in IPrintAsyncNotifyDataObject gekapselten Daten verwendet wird. |
Hinweise
Lauschende Anwendungen müssen ReleaseData aufrufen, wenn sie die mit AcquireData abgerufenen Benachrichtigungsdaten verarbeitet haben.
Die IPrintAsyncNotifyDataObject-Schnittstelle muss so implementiert werden, dass sichergestellt wird, dass ein Aufruf von IUnknown::Release das Objekt nicht freigibt, wenn eine lauschende Anwendung die Nutzung der Daten des Objekts nicht abgeschlossen hat. Wenn ein Aufruf von Release auftritt, wenn eine Anwendung AcquireData aufgerufen hat, aber noch nicht ReleaseData aufgerufen hat, darf das Objekt nicht freigegeben werden. Aus diesem Grund wird empfohlen, dass AcquireDataIUnknown::AddRef verwendet, um die Verweisanzahl des Objekts zu erhöhen und die Anzahl von ReleaseData zu verringern.
Lauschendanwendungen können sowohl innerhalb des Druckspoolers als auch außerhalb des Prozesses leben. Wenn sich der Listener außerhalb dieses Prozesses befindet, kann er nur auf die IPrintAsyncNotifyDataObject-Methoden zugreifen. Wenn Ihr IPrintAsyncNotifyDataObject auch eine eigene Schnittstelle implementiert, sollten Sie sich daher bewusst sein, dass die Methoden Ihrer Schnittstelle nur für lauschende Anwendungen innerhalb des Druckspoolers-Prozesses verfügbar sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | prnasnot.h |