PrintAsyncNotifyUserFilter enumeration (prnasnot.h)

Article
03/13/2023

Specifies whether notifications will go only to listening applications that are associated with the same user as the Print Spooler-hosted sender, or go to a broader set of listening applications.

Syntax

typedef enum {
  kPerUser,
  kAllUsers
} PrintAsyncNotifyUserFilter;

Constants


`kPerUser` When passed to CreatePrintAsyncNotifyChannel , kPerUser indicates that notifications will go only to listening applications that are using Client Impersonation to impersonate the same user as the Print Spooler-hosted sender. For example, if the Print Spooler-hosted sender sends a notification that a print job has finished printing, only listening applications impersonating the user that submitted the job will receive notification. When passed to RegisterForPrintAsyncNotifications, kPerUser indicates that the listener will receive notifications only from senders that are impersonating the same user as the listener.
`kAllUsers` When passed to CreatePrintAsyncNotifyChannel , kAllUsers indicates that notifications will go to all listening applications, regardless of the user; as long as the sender has administration privileges on the associated print queue or print server. When passed to RegisterForPrintAsyncNotifications, kAllUsers indicates that notifications will go to all listening applications whose associated user has administration privileges on the print queue or print server.

kPerUser
When passed to CreatePrintAsyncNotifyChannel
, kPerUser indicates that notifications will go only to listening applications that are using Client Impersonation to impersonate the same user as the Print Spooler-hosted sender. For example, if the Print Spooler-hosted sender sends a notification that a print job has finished printing, only listening applications impersonating the user that submitted the job will receive notification. When passed to RegisterForPrintAsyncNotifications, kPerUser indicates that the listener will receive notifications only from senders that are impersonating the same user as the listener.

kAllUsers
When passed to CreatePrintAsyncNotifyChannel
, kAllUsers indicates that notifications will go to all listening applications, regardless of the user; as long as the sender has administration privileges on the associated print queue or print server. When passed to RegisterForPrintAsyncNotifications, kAllUsers indicates that notifications will go to all listening applications whose associated user has administration privileges on the print queue or print server.

Remarks

Regardless of which value is passed, listeners will receive only the types of notifications for which they have registered.

A user may be simultaneously logged on to multiple terminal server sessions. All of the user's applications, regardless of which session hosts them, will receive notifications for which they have registered.

Requirements

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