IPrintAsyncNotifyChannel-Schnittstelle (prnasnot.h)
Stellt einen Kommunikationskanal dar, den Komponenten, die vom Druckspooler gehostet werden, verwenden, um Benachrichtigungen an Anwendungen zu senden. Wenn der Kanal bidirektional ist, können Anwendungen denselben Kanal verwenden, um Antworten zurück an die Komponente zu senden.
Vererbung
Die IPrintAsyncNotifyChannel-Schnittstelle erbt von der IUnknown-Schnittstelle . IPrintAsyncNotifyChannel verfügt auch über die folgenden Membertypen:
Methoden
Die IPrintAsyncNotifyChannel-Schnittstelle verfügt über diese Methoden.
| IPrintAsyncNotifyChannel::CloseChannel Schließt den Kanal. (IPrintAsyncNotifyChannel.CloseChannel) |
| IPrintAsyncNotifyChannel::SendNotification Sendet eine Benachrichtigung von einer Komponente, die vom Druckspooler gehostet wird, an eine oder mehrere lauschende Anwendungen oder sendet eine Antwort von einer Anwendung zurück an eine Komponente. |
Hinweise
Objekte, die diese Schnittstelle implementieren, werden vom Print Spooler als Reaktion auf einen Aufruf von CreatePrintAsyncNotifyChannel durch eine von Print Spooler gehostete Komponente erstellt.
Rufen Sie IPrintAsyncNotifyChannel::Release only auf:
- , wenn es sich um eine explizite Übereinstimmung mit einem früheren IPrintAsyncNotifyChannel::AddRef-Aufruf handelt.
- , wenn es sich bei dem Kanal um einen uniDirektionalen Kanal handelt und Sie den Zeiger verlassen, der in einem erfolgreichen Aufruf von CreatePrintAsyncNotifyChannel empfangen wurde.
- wenn, nachdem Sie einen BiDirectional-Kanal oder in der Implementierung von IPrintAsyncNotifyCallback::OnEventNotify erstellt haben und:
- Sie haben IPrintAsyncNotifyChannel::SendNotification oder IPrintAsyncNotifyChannel::CloseChannel OR nicht aufgerufen.
- Sie haben keinen erneuten Aufruf von IPrintAsyncNotifyChannel::SendNotification oder IPrintAsyncNotifyChannel::CloseChannel wiederholt, bei dem ein Fehler ODER aufgetreten ist.
- Auf der Serverseite haben Sie keinen erneuten Aufruf von IPrintAsyncNotifyChannel::SendNotification ausgeführt, der mit dem Rückgabewert NO_LISTENER OR erfolgreich war.
- Auf der Clientseite haben Sie keinen erneuten Aufruf von IPrintAsyncNotifyChannel::SendNotification ausgeführt, der mit dem Rückgabewert CHANNEL_ACQUIRED erfolgreich war.
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 |