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

Article translations Article translations
Article ID: 160456 - View products that this article applies to.
This article was previously published under Q160456
4.00 WINDOWS kbprint kbhowto
Expand all | Collapse all

SUMMARY

Printers in Windows 95 can be set to a state called Work Offline in which print jobs are spooled and held. The print jobs are not despooled until Work Offline is deactivated. The Work Offline state is reflected by the Work Offline item in the Printer's File menu that indicates the condition with a check mark.

MORE INFORMATION

While the Work Offline state is reflected by the condition of the PRINTER_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 a bitfield of Attribute bits for that printer. See the Win32 SDK online documents for a complete description of this structure member and its values.

Note that the Work Offline state of a printer in Windows is distinctly different from a printer being Off-line. The difference is that the PRINTER_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 the GetPrinter 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.

REFERENCES

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

Properties

Article ID: 160456 - Last Review: November 21, 2006 - Revision: 2.2
APPLIES TO
  • Microsoft Win32 Application Programming Interface, when used with:
    • Microsoft Windows 95
Keywords: 
kbhowto KB160456
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.

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com