IPrintAsyncNotifyChannel interface (prnasnot.h)

Represents a communication channel that components that are hosted by the print spooler use to send notifications to applications. If the channel is bidirectional, applications can use the same channel to send responses back to the component.

Inheritance

The IPrintAsyncNotifyChannel interface inherits from the IUnknown interface. IPrintAsyncNotifyChannel also has these types of members:

Methods

The IPrintAsyncNotifyChannel interface has these methods.

 
IPrintAsyncNotifyChannel::CloseChannel

Closes the channel. (IPrintAsyncNotifyChannel.CloseChannel)
IPrintAsyncNotifyChannel::SendNotification

Sends a notification from a component that is hosted by the print spooler to one or more listening applications, or sends a response from an application back to a component.

Remarks

Objects implementing this interface are created by the Print Spooler in response to a call of CreatePrintAsyncNotifyChannel by a Print Spooler-hosted component.

Call IPrintAsyncNotifyChannel::Release only:

  1. if it is an explicit match to an earlier IPrintAsyncNotifyChannel::AddRef call.
  2. if the channel is a UniDirectional channel and you are abandoning the pointer received in a successful call to CreatePrintAsyncNotifyChannel.
  3. if, after you created a BiDirectional channel or in the implementation of IPrintAsyncNotifyCallback::OnEventNotify and:
    1. you did not call IPrintAsyncNotifyChannel::SendNotification or IPrintAsyncNotifyChannel::CloseChannel OR
    2. you did not retry a call to IPrintAsyncNotifyChannel::SendNotification or IPrintAsyncNotifyChannel::CloseChannel that failed OR
    3. on the server side, you did not retry a call to IPrintAsyncNotifyChannel::SendNotification that succeeded with the return value NO_LISTENER OR
    4. on the client side, you did not retry a call to IPrintAsyncNotifyChannel::SendNotification that succeeded with return value CHANNEL_ACQUIRED.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header prnasnot.h

See also

Asynchronous Printing Notification Interfaces

Printing