Retrieve spooled file data

[Vzor-]

Adds the ability to obtain raw, spool file data on Windows printers which have 'keep spooled documents' feature enabled.

• Requires System property printer.status.jobdata is set to true, e.g.
  • Environment variable QZ_OPTS: -Dprinter.status.jobdata=true
    --OR--
  • qz-tray.properties: printer.status.jobdata=true.

Closes #923

Note: This feature does not work by default on Windows 11 ARM, the spool directory permissions don't allow it.

Edited by @tresf

---

TODO:

• feature should be disabled by default
• test permissions when wrong user tries to read a spooled file

see #923

[tresf]

@Vzor- I'm testing this on Windows 11 running on ARM64, and I get the following error:

[ERROR] 2022-08-14T01:58:24,319 @ qz.printer.status.StatusSession:121
	Failed to retrieve job data from job #5
java.io.FileNotFoundException: Failed to locate spooler output.
	at qz.utils.WindowsUtilities.getSpoolerLocation(WindowsUtilities.java:114) ~[production/:?]
	at qz.printer.status.StatusSession.getJobData(StatusSession.java:114) ~[production/:?]
	at qz.printer.status.StatusSession.createJobDataStream(StatusSession.java:85) ~[production/:?]
	at qz.printer.status.StatusSession.statusChanged(StatusSession.java:45) ~[production/:?]
	at qz.printer.status.StatusMonitor.statusChanged(StatusMonitor.java:168) ~[production/:?]
	at qz.printer.status.WmiPrinterStatusThread.sendPendingStatuses(WmiPrinterStatusThread.java:214) ~[production/:?]
	at qz.printer.status.WmiPrinterStatusThread.ingestChange(WmiPrinterStatusThread.java:137) ~[production/:?]
	at qz.printer.status.WmiPrinterStatusThread.run(WmiPrinterStatusThread.java:108) ~[production/:?]

I can confirm that HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Print\Printers\DefaultSpoolDirectory exists and does point to C:\Windows\system32\spool\PRINTERS and that the location exists, however trying to browse it, I get "Access denied".

C:\>cd C:\Windows\system32\spool\PRINTERS
Access is denied.

[tresf]

Question posted publicly: https://superuser.com/questions/1740212

[tresf]

Ok, so I think this is working as a standard user as of 7e151b7. The Files.exists() returns false if you don't have permission, however the Files.isDirectory() will return true if exists even if you can't read it. 🎉

Per findings in https://superuser.com/questions/1740212, a user can read their own spooled files, just not the parent directory.

[tresf]

@Vzor- FYI, I'm going to squash the commits and rebase on master. A backup of the individual commits is here: master...tresf:tray:job-data-backup.