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

• Microsoft Win32 Application Programming Interface (API), on platform(s):
  • Microsoft Windows 95

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.

REFERENCES

For additional information about calling Win32 Spooler API functions, please see the following article(s) in the Microsoft Knowledge Base:

Q158828 How To Call Win32 Spooler Enumeration APIs Properly

Q140285 How to Modify Printer Settings by Using SetPrinter

Q160129 How To Get the Status of a Printer and a Print Job

Additional query words: 4.00 KbDSI GdiSpool Printer Properties

Keywords          : kbSDKWin32 kbWinOS95 kbDSupport 
Version           : winnt:
Platform          : winnt 
Issue type        : kbhowto 

Last Reviewed: June 30, 1999