3.1.4.9 Printing-Related Notification Methods

The Printing-Related Notification methods support the registration for and receipt of notification events concerning a specific print job. The following table presents a list of printing-related notification methods and indicates that they have no counterparts in the Print System Remote Protocol [MS-RPRN]. All methods are specified in sections that follow.

 [MS-PAR] method

Description

 [MS-RPRN] method

RpcSyncRegisterForRemoteNotifications

Opens a notification handle by using a printer handle or print server handle, to listen for remote printer change notifications.

Opnum 58

None.

RpcSyncUnRegisterForRemoteNotifications

Closes a notification handle opened by calling RpcSyncRegisterForRemoteNotifications (section 3.1.4.9.1).

Opnum 59

None.

RpcSyncRefreshRemoteNotifications

Gets notification information for all requested members. This is called by a client if the "RemoteNotifyData Flags" key in the RpcPrintPropertiesCollection (section 2.2.4) instance, which was returned as part of the notification from an RpcAsyncGetRemoteNotifications call, has the PRINTER_NOTIFY_INFO_DISCARDED bit set ([MS-RPRN] section 2.2.3.2).

Opnum 60

None.

RpcAsyncGetRemoteNotifications

Polls the print server for specified change notifications. A call to this method is suspended until the server has a new change notification for the client. Subsequently, the client calls this method again to poll for additional notifications from the server.

Opnum 61

None.