You are currently offline, waiting for your internet to reconnect

HOWTO: How To Change the Work Offline Status of a Printer

This article was previously published under Q160456
Retired KB Content Disclaimer
This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.
4.00WINDOWSkbprint kbhowto
Printers in Windows 95 can be set to a state called Work Offline in whichprint jobs are spooled and held. The print jobs are not despooled untilWork Offline is deactivated. The Work Offline state is reflected by theWork Offline item in the Printer's File menu that indicates the conditionwith a check mark.
While the Work Offline state is reflected by the condition of thePRINTER_STATUS_USER_INTERVENTION bit in a PRINTER_INFO structure's Status member, it is actually an attribute of the printer. As such, it is indicated and controlled by the PRINTER_ATTRIBUTE_WORK_OFFLINE bit of a PRINTER_INFO_2 structure's Attribute member. The Attribute member is abitfield of Attribute bits for that printer. See the Win32 SDK onlinedocuments for a complete description of this structure member and itsvalues.

Note that the Work Offline state of a printer in Windows is distinctlydifferent from a printer being Off-line. The difference is that thePRINTER_ATTRIBUTE_WORK_OFFLINE attribute applies to a Window's Print Queue and effects how the queue behaves, while the Off-line status of a physical printer device is set on the device. The Off-line status of a physical printer can be determined from the Status members of either a PRINTER_INFO or JOB_INFO structure. See the Printer and Print Job status article in the REFERENCE section in this article for details.

Attribute information for a printer can be read and written by theGetPrinter and SetPrinter API functions. To determine if a printer is currently in the Work Offline state, perform a logical AND of the predefined constant PRINTER_ATTRIBUTE_WORK_OFFLINE and the Attribute member of a PRINTER_INFO_2 structure with the C language "&" operator. To change the Work Offline state of a printer, follow these steps:
  1. Retrieve a PRINTER_INFO_2 structure for the printer by calling the GetPrinter function multiple times.
  2. Change the PRINTER_ATTRIBUTE_WORK_OFFLINE bit of a PRINTER_INFO_2 structure's Attribute member. The following sample code illustrates how to clear or set a bit of this bitfield properly:
       if (pi2->Attributes & PRINTER_ATTRIBUTE_WORK_OFFLINE)   {       DWORD   dwStatusMask;       /* set, so clear the bit */        dwStatusMask = ~(DWORD)(PRINTER_ATTRIBUTE_WORK_OFFLINE);       pi2->Attributes = pi2->Attributes & dwStatusMask;   }   else   {       /* not set, so set it */        pi2->Attributes = pi2->Attributes |       PRINTER_ATTRIBUTE_WORK_OFFLINE;   }						
  3. Call the SetPrinter function to set the state of the printer by passing the modified structure.
Note that the PRINTER_ATTRIBUTE_WORK_OFFLINE attribute is not supported for printers in Windows NT.
For additional information about calling Win32 Spooler API functions, please see the following article(s) in the Microsoft Knowledge Base:
158828 How To Call Win32 Spooler Enumeration APIs Properly
140285 How to Modify Printer Settings by Using SetPrinter
160129 How To Get the Status of a Printer and a Print Job
4.00 KbDSI GdiSpool Printer Properties

Article ID: 160456 - Last Review: 11/21/2006 15:31:26 - Revision: 2.2

  • Microsoft Win32 Application Programming Interface
  • kbhowto KB160456