ReportPrinterStatus

This function returns the status of a printer or printing operation that is in progress.

At a Glance

Header file:	Prnport.h
Component:
Platforms:	H/PC, Palm-size PC
Windows CE versions:	2.0 and later

Syntax

BOOL WINAPI ReportPrinterStatus( DWORD dwStatus,
LPCTSTR lpPortName, LPCTSTR lpPrinterName, LPARAM lparam );

Parameters

dwStatus

One of the following flags:

PRINTER_E_OFFLINE
PRINTER_E_NOPAPER
PRINTER_E_DEVICE_FAULT
PRINTER_E_TIMEOUT
PRINTER_E_PAPERJAM
PRINTER_N_JOB_COMPLETE
PRINTER_N_PRINTING

lpPortName

Pointer to the printer port.

lpPrinterName

Pointer to the printer name.

lparam

Specifies a 32-bit message parameter.

Remarks

This function uses a registry setting to determine printer time-out errors for IR and serial printing. The time-out default value is 45seconds. It can be changed using the HKEY_LOCAL_MACHINE\PrintSettings\TimeOut registry key.