2.2.3.8 Printer Notification Values
The Printer Notification Values specify types of changes in printer data and/or state for which print clients can be notified.
The following constants can be used in the fdwOptions parameters of the RpcRemoteFindFirstPrinterChangeNotification (section 3.1.4.10.3) and RpcRemoteFindFirstPrinterChangeNotificationEx (section 3.1.4.10.4) methods. They specify the categories of printers for which change notifications are returned.
|
Name/value |
Description |
|---|---|
|
0x00000000 |
Return notifications for 2D printers only. |
|
PRINTER_NOTIFY_CATEGORY_ALL 0x00010000 |
Return notifications for both 2D and 3D printers.<160><161> |
|
PRINTER_NOTIFY_CATEGORY_3D 0x00020000 |
Return notifications for 3D printers only.<162> |
The following constants can be used in the Data member of an RPC_V2_NOTIFY_INFO_DATA (section 2.2.1.13.4) structure.<163> Reserved members are specified by Notification Data Type Values (section 2.2.3.5), and String values are specified in PRINTER_INFO (section 2.2.1.10) structures. The print server passes these notification values to a print client using RpcRouterReplyPrinterEx (section 3.2.4.1.4).
|
Name/value |
Description |
|---|---|
|
PRINTER_NOTIFY_FIELD_ATTRIBUTES 0x000D |
Specifies that printer attributes have changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new Attributes value. |
|
PRINTER_NOTIFY_FIELD_AVERAGE_PPM 0x0015 |
Specifies that the average pages per minute for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new AveragePPM value. |
|
PRINTER_NOTIFY_FIELD_BRANCH_OFFICE_PRINTING 0x001C |
Specifies that the EnableBranchOfficePrinting printer data value (section 2.2.3.11) for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new value for the EnableBranchOfficePrinting printer data value.<164> |
|
PRINTER_NOTIFY_FIELD_BYTES_PRINTED 0x0019 |
Specifies that the number of bytes that have been printed has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new cTotalBytes value. |
|
PRINTER_NOTIFY_FIELD_CJOBS 0x0014 |
Specifies that the number of print jobs that are queued for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new cJobs value. |
|
PRINTER_NOTIFY_FIELD_COMMENT 0x0005 |
Specifies that the printer comment has changed. Reserved contains TABLE_STRING, and Data.String contains the new comment (pComment in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_DATATYPE 0x000B |
Specifies that the printer default data type has changed. Reserved contains TABLE_STRING, and Data.String contains the new comment (pDatatype in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY 0x000F |
Specifies that the default priority for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new DefaultPriority. |
|
PRINTER_NOTIFY_FIELD_DEVMODE 0x0007 |
Specifies that the default _DEVMODE (section 2.2.2.1) structure for the printer has changed. Reserved contains TABLE_DEVMODE, and Data.DevMode contains the new DEVMODE structure (pDevMode in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_DRIVER_NAME 0x0004 |
Specifies that the printer driver for the printer has changed. Reserved contains TABLE_STRING, and Data.String contains the new printer driver name (pDriverName in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_LOCATION 0x0006 |
Specifies that the printer location has changed. Reserved contains TABLE_STRING, and Data.String contains the new location description value (pLocation in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_OBJECT_GUID 0x001A |
Specifies that the printer object GUID has changed.<165> Reserved contains TABLE_STRING, and Data.String contains the new printer GUID value (pszObjectGUID in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_PAGES_PRINTED 0x0017 |
Specifies that the number of pages that have been printed for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new PagesPrinted value. |
|
PRINTER_NOTIFY_FIELD_PARAMETERS 0x000A |
Specifies that the default print processor parameters for the printer have changed. Reserved contains TABLE_STRING, and Data.String contains the new print processor parameters value (pParameters in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_PORT_NAME 0x0003 |
Specifies that the default port name for the printer has changed. Reserved contains TABLE_STRING, and Data.String contains the new port name value (pPortName in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_PRINTER_NAME 0x0001 |
Specifies that the printer name has changed. Reserved contains TABLE_STRING, and Data.String contains the new printer name value (pPrinterName in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR 0x0009 |
Specifies that the print processor associated with the printer has changed. Reserved contains TABLE_STRING, and Data.String contains the new print processor name value (pPrintProcessor in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_PRIORITY 0x000E |
Specifies that the current priority for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new Priority value. |
|
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR 0x000C |
Specifies that the security descriptor for the printer has changed. Reserved contains TABLE_SECURITYDESCRIPTOR, and Data.SecurityDescriptor contains the new security descriptor value (pSecurityDescriptor in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_SEPFILE 0x0008 |
Specifies that the separator page for the printer has changed. Reserved contains TABLE_STRING, and Data.String contains the new separator page value (pSepFile in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_SERVER_NAME 0x0000 |
Specifies that the server name for the printer has changed. Reserved contains TABLE_STRING, and Data.String contains the new server name value (pServerName in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_SHARE_NAME 0x0002 |
Specifies that the printer share name has changed. Reserved contains TABLE_STRING, and Data.String contains the new share name value (pShareName in PRINTER_INFO structures). |
|
PRINTER_NOTIFY_FIELD_START_TIME 0x0010 |
Specifies that the earliest start time for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new StartTime value. |
|
PRINTER_NOTIFY_FIELD_STATUS 0x0012 |
Specifies that the status for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new Status value. |
|
PRINTER_NOTIFY_FIELD_TOTAL_BYTES 0x0018 |
Specifies that the total number of bytes that have been printed on the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new cTotalBytes value. |
|
PRINTER_NOTIFY_FIELD_TOTAL_PAGES 0x0016 |
Specifies that the total number of pages that have been printed on the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new cTotalPagesPrinted value. |
|
PRINTER_NOTIFY_FIELD_UNTIL_TIME 0x0011 |
Specifies that the latest print time for the printer has changed. Reserved contains TABLE_DWORD, and Data.dwData[0] contains the new UntilTime value. |