34 out of 46 rated this helpful - Rate this topic

Win32_Printer class

The Win32_Printer WMI class represents a device connected to a computer running on a Microsoft Windows operating system that can produce a printed image or text on paper or other medium.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

class Win32_Printer : CIM_Printer
{
  uint32   Attributes;
  uint16   Availability;
  string   AvailableJobSheets[];
  uint32   AveragePagesPerMinute;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   Caption;
  string   CharSetsSupported[];
  string   Comment;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  uint16   CurrentCapabilities[];
  string   CurrentCharSet;
  uint16   CurrentLanguage;
  string   CurrentMimeType;
  string   CurrentNaturalLanguage;
  string   CurrentPaperType;
  boolean  Default;
  uint16   DefaultCapabilities[];
  uint32   DefaultCopies;
  uint16   DefaultLanguage;
  string   DefaultMimeType;
  uint32   DefaultNumberUp;
  string   DefaultPaperType;
  uint32   DefaultPriority;
  string   Description;
  uint16   DetectedErrorState;
  string   DeviceID;
  boolean  Direct;
  boolean  DoCompleteFirst;
  string   DriverName;
  boolean  EnableBIDI;
  boolean  EnableDevQueryPrint;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorInformation[];
  uint16   ExtendedDetectedErrorState;
  uint16   ExtendedPrinterStatus;
  boolean  Hidden;
  uint32   HorizontalResolution;
  datetime InstallDate;
  uint32   JobCountSinceLastReset;
  boolean  KeepPrintedJobs;
  uint16   LanguagesSupported[];
  uint32   LastErrorCode;
  boolean  Local;
  string   Location;
  uint16   MarkingTechnology;
  uint32   MaxCopies;
  uint32   MaxNumberUp;
  uint32   MaxSizeSupported;
  string   MimeTypesSupported[];
  string   Name;
  string   NaturalLanguagesSupported[];
  boolean  Network;
  uint16   PaperSizesSupported[];
  string   PaperTypesAvailable[];
  string   Parameters;
  string   PNPDeviceID;
  string   PortName;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   PrinterPaperNames[];
  uint32   PrinterState;
  uint16   PrinterStatus;
  string   PrintJobDataType;
  string   PrintProcessor;
  uint32   Priority;
  boolean  Published;
  boolean  Queued;
  boolean  RawOnly;
  string   SeparatorFile;
  string   ServerName;
  boolean  Shared;
  string   ShareName;
  boolean  SpoolEnabled;
  datetime StartTime;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  datetime TimeOfLastReset;
  datetime UntilTime;
  uint32   VerticalResolution;
  boolean  WorkOffline;
};

Members

The Win32_Printer class has these types of members:

Methods
Properties

Methods

The Win32_Printer class has these methods.

Method	Description
AddPrinterConnection	Adds a connection to the printer. Windows 2000 and Windows NT 4.0: This method is not available.
CancelAllJobs	Cancels all jobs. Windows 2000 and Windows NT 4.0: This method is not available.
GetSecurityDescriptor	Returns the security descriptor that controls access to the printer. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.
Pause	Pauses the print queue. Windows 2000 and Windows NT 4.0: This method is not available.
PrintTestPage	Prints a test page. Windows 2000 and Windows NT 4.0: This method is not available.
RenamePrinter	Renames a printer. Windows 2000 and Windows NT 4.0: This method is not available.
Reset	Not implemented. For more information about how to implement this method, see the Reset method in CIM_Printer.
Resume	Resumes paused print queue. Windows 2000 and Windows NT 4.0: This method is not available.
SetDefaultPrinter	Sets the default printer. Windows 2000 and Windows NT 4.0: This method is not available.
SetPowerState	Not implemented. For more information about how to implement this method, see the SetPowerState method in CIM_Printer.
SetSecurityDescriptor	Writes an updated version of the security descriptor that controls access to the printer. This method is available starting with Windows Vista. Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This method is not available.

Properties

The Win32_Printer class has these properties.

Attributes

Data type: uint32
Access type: Read-only

Bitmap of attributes for a Windows-based printing device.

Value used to set the bit	Meaning
PRINTER_ATTRIBUTE_QUEUED 1 (0x1)	Queued Print jobs are buffered and queued.
PRINTER_ATTRIBUTE_DIRECT 2 (0x2)	Direct Document to be sent directly to the printer. This value is used if print jobs are not queued correctly.
PRINTER_ATTRIBUTE_DEFAULT 4 (0x4)	Default Default printer on a computer.
PRINTER_ATTRIBUTE_SHARED 8 (0x8)	Shared Available as a shared network resource.
PRINTER_ATTRIBUTE_NETWORK 16 (0x10)	Network Attached to a network. If both Local and Network bits are set, this indicates a network printer.
PRINTER_ATTRIBUTE_HIDDEN 32 (0x20)	Hidden Hidden from some users on the network.
PRINTER_ATTRIBUTE_LOCAL 64 (0x40)	Local Directly connected to a computer. If both Local and Network bits are set, this indicates a network printer.
PRINTER_ATTRIBUTE_ENABLEDEVQ 128 (0x80)	EnableDevQ Enable the queue on the printer if available.
PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS 256 (0x100)	KeepPrintedJobs Spooler should not delete documents after they are printed.
PRINTER_ATTRIBUTE_DO_COMPLETE_FIRST 512 (0x200)	DoCompleteFirst Start jobs that are finished spooling first.
PRINTER_ATTRIBUTE_WORK_OFFLINE 1024 (0x400)	WorkOffline Queue print jobs when a printer is not available.
PRINTER_ATTRIBUTE_ENABLE_BIDI 2048 (0x800)	EnableBIDI Enable bidirectional printing.
PRINTER_ATTRIBUTE_RAW_ONLY 4096 (0x1000)	Allow only raw data type jobs to be spooled.
PRINTER_ATTRIBUTE_PUBLISHED 8192 (0x2000)	Published Published in the network directory service.

Availability

Data type: uint16
Access type: Read-only

Availability and status of the device. Inherited from CIM_LogicalDevice.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	Running or Full Power
4 (0x4)	Warning
5 (0x5)	In Test
6 (0x6)	Not Applicable
7 (0x7)	Power Off
8 (0x8)	Off Line
9 (0x9)	Off Duty
10 (0xA)	Degraded
11 (0xB)	Not Installed
12 (0xC)	Install Error
13 (0xD)	Power Save - Unknown The device is known to be in a power save mode, but its exact status is unknown.
14 (0xE)	Power Save - Low Power Mode The device is in a power save state but is still functioning, and may exhibit degraded performance.
15 (0xF)	Power Save - Standby The device is not functioning, but could be brought to full power quickly.
16 (0x10)	Power Cycle
17 (0x11)	Power Save - Warning The device is in a warning state, though also in a power save mode.

AvailableJobSheets

Data type: string array
Access type: Read-only

Array of all the job sheets available on a printer. Can also be used to describe the banner that a printer might provide at the beginning of each job, or other user-specified options. This property is inherited from CIM_Printer.

AveragePagesPerMinute

Data type: uint32
Access type: Read-only

Printing rate, in average number of pages per minute, that a printer can produce output.

Capabilities

Data type: uint16 array
Access type: Read-only

Array of printer capabilities. This property is inherited from CIM_Printer.

Value	Meaning
0 (0x0)	Unknown
1 (0x1)	Other
2 (0x2)	Color Printing
3 (0x3)	Duplex Printing
4 (0x4)	Copies
5 (0x5)	Collation
6 (0x6)	Stapling
7 (0x7)	Transparency Printing
8 (0x8)	Punch
9 (0x9)	Cover
10 (0xA)	Bind
11 (0xB)	Black and White Printing
12 (0xC)	One-Sided
13 (0xD)	Two-Sided Long Edge
14 (0xE)	Two-Sided Short Edge
15 (0xF)	Portrait
16 (0x10)	Landscape
17 (0x11)	Reverse Portrait
18 (0x12)	Reverse Landscape
19 (0x13)	Quality High
20 (0x14)	Quality Normal
21 (0x15)	Quality Low

CapabilityDescriptions

Data type: string array
Access type: Read-only

Array of free-form strings that provide detailed explanations for the printer features indicated in the Capabilities array. Each entry of this array is related to an entry in the Capabilities array that is located in the same index. This property is inherited from CIM_Printer.

Caption

Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

Short description of an object—a one-line string. This property is inherited from CIM_ManagedSystemElement.

CharSetsSupported

Data type: string array
Access type: Read-only

Array of available character sets for output. Strings provided in this property must conform to the semantics and syntax specified by section 4.1.2 ("Charset parameters") in RFC 2046 (MIME Part 2) and contained in the IANA character-set registry. Examples include, UTF-8, us-ASCII, and iso-8859-1. This property is inherited from CIM_Printer.

Comment

Data type: string
Access type: Read/write

Comment for a print queue.

Example: Color printer

ConfigManagerErrorCode

Data type: uint32
Access type: Read-only

Win32 Configuration Manager error code.

Value	Meaning
0 (0x0)	Device is working properly.
1 (0x1)	Device is not configured correctly.
2 (0x2)	Windows cannot load the driver for this device.
3 (0x3)	Driver for this device might be corrupted, or the system may be low on memory or other resources.
4 (0x4)	Device is not working properly. One of its drivers or the registry might be corrupted.
5 (0x5)	Driver for the device requires a resource that Windows cannot manage.
6 (0x6)	Boot configuration for the device conflicts with other devices.
7 (0x7)	Cannot filter.
8 (0x8)	Driver loader for the device is missing.
9 (0x9)	Device is not working properly. The controlling firmware is incorrectly reporting the resources for the device.
10 (0xA)	Device cannot start.
11 (0xB)	Device failed.
12 (0xC)	Device cannot find enough free resources to use.
13 (0xD)	Windows cannot verify the device's resources.
14 (0xE)	Device cannot work properly until the computer is restarted.
15 (0xF)	Device is not working properly due to a possible re-enumeration problem.
16 (0x10)	Windows cannot identify all of the resources that the device uses.
17 (0x11)	Device is requesting an unknown resource type.
18 (0x12)	Device drivers must be reinstalled.
19 (0x13)	Failure using the VxD loader.
20 (0x14)	Registry might be corrupted.
21 (0x15)	System failure. If changing the device driver is ineffective, see the hardware documentation. Windows is removing the device.
22 (0x16)	Device is disabled.
23 (0x17)	System failure. If changing the device driver is ineffective, see the hardware documentation.
24 (0x18)	Device is not present, not working properly, or does not have all of its drivers installed.
25 (0x19)	Windows is still setting up the device.
26 (0x1A)	Windows is still setting up the device.
27 (0x1B)	Device does not have a valid log configuration.
28 (0x1C)	Device drivers are not installed.
29 (0x1D)	Device is disabled. The device firmware did not provide the required resources.
30 (0x1E)	Device is using an IRQ resource that another device is using.
31 (0x1F)	Device is not working properly. Windows cannot load the required device drivers.

ConfigManagerUserConfig

Data type: boolean
Access type: Read-only

If TRUE, the device is using a user-defined configuration. This property is inherited from CIM_LogicalDevice.

CreationClassName

Data type: string
Access type: Read-only

Name of the first concrete class to appear in the inheritance chain used to create an instance. When used with other key properties of the class, the property allows all instances of this class and its subclasses to be identified uniquely. This property is inherited from CIM_LogicalDevice.

CurrentCapabilities

Data type: uint16 array
Access type: Read-only

Array of printer capabilities that are being used currently. An entry in this property must also be listed in the Capabilities array. This property is inherited from CIM_Printer.

Value	Meaning
0 (0x0)	Unknown
1 (0x1)	Other
2 (0x2)	Color Printing
3 (0x3)	Duplex Printing
4 (0x4)	Copies
5 (0x5)	Collation
6 (0x6)	Stapling
7 (0x7)	Transparency Printing
8 (0x8)	Punch
9 (0x9)	Cover
10 (0xA)	Bind
11 (0xB)	Black and White Printing
12 (0xC)	One-Sided
13 (0xD)	Two-Sided Long Edge
14 (0xE)	Two-Sided Short Edge
15 (0xF)	Portrait
16 (0x10)	Landscape
17 (0x11)	Reverse Portrait
18 (0x12)	Reverse Landscape
19 (0x13)	Quality High
20 (0x14)	Quality Normal
21 (0x15)	Quality Low

CurrentCharSet

Data type: string
Access type: Read-only

The character set currently used for output. Strings provided in this property must conform to the semantics and syntax specified by section 4.1.2 ("Charset parameters") in RFC 2046 (MIME Part 2) and contained in the IANA character-set registry. Examples include, utf-8, us-ASCII, and iso-8859-1. This property is inherited from CIM_Printer.

CurrentLanguage

Data type: uint16
Access type: Read-only
Qualifiers: ValueMap

Printer language currently used. The language used must be listed in the LanguagesSupported property. This property is inherited from CIM_Printer.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	PCL
4 (0x4)	HPGL
5 (0x5)	PJL
6 (0x6)	PS
7 (0x7)	PSPrinter
8 (0x8)	IPDS
9 (0x9)	PPDS
10 (0xA)	EscapeP
11 (0xB)	Epson
12 (0xC)	DDIF
13 (0xD)	Interpress
14 (0xE)	ISO6429
15 (0xF)	LineData
16 (0x10)	DODCA
17 (0x11)	REGIS
18 (0x12)	SCS
19 (0x13)	SPDL
20 (0x14)	TEK4014
21 (0x15)	PDS
22 (0x16)	IGP
23 (0x17)	CodeV
24 (0x18)	DSCDSE
25 (0x19)	WPS
26 (0x1A)	LN03
27 (0x1B)	CCITT
28	QUIC
29 (0x1D)	CPAP
30 (0x1E)	DecPPL
31 (0x1F)	SimpleText
32 (0x20)	NPAP
33 (0x21)	DOC
34 (0x22)	imPress
35 (0x23)	Pinwriter
36 (0x24)	NPDL
37 (0x25)	NEC201PL
38 (0x26)	Automatic
39 (0x27)	Pages
40 (0x28)	LIPS
41 (0x29)	TIFF
42 (0x2A)	Diagnostic
43 (0x2B)	CaPSL
44 (0x2C)	EXCL
45 (0x2D)	LCDS
46 (0x2E)	XES
47 (0x2F)	MIME
48 (0x30)	XPS
49 (0x31)	HPGL2
50 (0x32)	PCLXL

CurrentMimeType

Data type: string
Access type: Read-only

MIME type currently being used if the CurrentLanguage is a MIME type (value = 47). This property is inherited from CIM_Printer.

CurrentNaturalLanguage

Data type: string
Access type: Read-only

Language that the printer is using for management currently. The language listed here must also be listed in the NaturalLanguagesSupported property. This property is inherited from CIM_Printer.

CurrentPaperType

Data type: string
Access type: Read-only

Type of paper the printer is using. Must be expressed in the form specified by the ISO/IEC 10175 Document Printing Application (DPA), which is summarized in Appendix C of RFC 1759 (Printer MIB). This property is inherited from CIM_Printer.

Default

Data type: boolean
Access type: Read-only

If TRUE, the printer is the default printer.

DefaultCapabilities

Data type: uint16 array
Access type: Read-only

Array of the printer capabilities used by default. Each entry in the DefaultCapabilities array must also be listed in the Capabilities array. This property is inherited from CIM_Printer.

Value	Meaning
0 (0x0)	Unknown
1 (0x1)	Other
2 (0x2)	Color Printing
3 (0x3)	Duplex Printing
4 (0x4)	Copies
5 (0x5)	Collation
6 (0x6)	Stapling
7	Transparency Printing
8 (0x8)	Punch
9 (0x9)	Cover
10 (0xA)	Bind
11 (0xB)	Black and White Printing
12 (0xC)	One-Sided
13 (0xD)	Two-Sided Long Edge
14 (0xE)	Two-Sided Short Edge
15 (0xF)	Portrait
16	Landscape
17 (0x11)	Reverse Portrait
18 (0x12)	Reverse Landscape
19 (0x13)	Quality High
20 (0x14)	Quality Normal
21 (0x15)	Quality Low

DefaultCopies

Data type: uint32
Access type: Read-only

Number of copies produced for one job—unless otherwise specified. This property is inherited from CIM_Printer.

DefaultLanguage

Data type: uint16
Access type: Read-only

Default printer language. The language listed here must also be listed in the LanguagesSupported property. This property is inherited from CIM_Printer.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	PCL
4 (0x4)	HPGL
5 (0x5)	PJL
6 (0x6)	PS
7 (0x7)	PSPrinter
8 (0x8)	IPDS
9 (0x9)	PPDS
10 (0xA)	EscapeP
11 (0xB)	Epson
12 (0xC)	DDIF
13 (0xD)	Interpress
14 (0xE)	ISO6429
15 (0xF)	LineData
16 (0x10)	DODCA
17 (0x11)	REGIS
18 (0x12)	SCS
19 (0x13)	SPDL
20 (0x14)	TEK4014
21 (0x15)	PDS
22 (0x16)	IGP
23 (0x17)	CodeV
24 (0x18)	DSCDSE
25 (0x19)	WPS
26 (0x1A)	LN03
27 (0x1B)	CCITT
28 (0x1C)	QUIC
29 (0x1D)	CPAP
30 (0x1E)	DecPPL
31 (0x1F)	SimpleText
32 (0x20)	NPAP
33 (0x21)	DOC
34 (0x22)	imPress
35 (0x23)	Pinwriter
36 (0x24)	NPDL
37 (0x25)	NEC201PL
38 (0x26)	Automatic
39 (0x27)	Pages
40 (0x28)	LIPS
41 (0x29)	TIFF
42 (0x2A)	Diagnostic
43 (0x2B)	CaPSL
44 (0x2C)	EXCL
45 (0x2D)	LCDS
46 (0x2E)	XES
47 (0x2F)	MIME
48 (0x30)	XPS
49 (0x31)	HPGL2
50 (0x32)	PCLXL

DefaultMimeType

Data type: string
Access type: Read-only

MIME type currently being used, if the DefaultLanguage value is a MIME type (value = 47). This property is inherited from CIM_Printer.

DefaultNumberUp

Data type: uint32
Access type: Read-only

Number of print-stream pages that the printer renders on one media sheet—unless a job specifies otherwise. This property is inherited from CIM_Printer.

DefaultPaperType

Data type: string
Access type: Read-only

Paper type that the printer uses—unless a print job specifies a different paper type. The string must be expressed in the form specified by ISO/IEC 1017 Document Printing Application (DPA), which is summarized in Appendix C of RFC 1759 (Printer MIB). This property is inherited from CIM_Printer.

DefaultPriority

Data type: uint32
Access type: Read/write

Default priority value assigned to each print job.

Description

Data type: string
Access type: Read-only

Description of an object. This property is inherited from CIM_ManagedSystemElement.

DetectedErrorState

Data type: uint16
Access type: Read-only

Printer error information. This property is inherited from CIM_Printer.

Value	Meaning
0 (0x0)	Unknown
1 (0x1)	Other
2 (0x2)	No Error
3 (0x3)	Low Paper
4 (0x4)	No Paper
5 (0x5)	Low Toner
6 (0x6)	No Toner
7 (0x7)	Door Open
8 (0x8)	Jammed
9 (0x9)	Offline
10 (0xA)	Service Requested
11 (0xB)	Output Bin Full

DeviceID

Data type: string
Access type: Read-only
Qualifiers: Key, Override

Unique identifier of the printer on a system. This property is inherited from CIM_LogicalDevice.

Direct

Data type: boolean
Access type: Read/write

If TRUE, the print job is sent directly to the printer. If FALSE, the print job is spooled.

DoCompleteFirst

Data type: boolean
Access type: Read/write

If TRUE, the printer starts jobs that are finished spooling. If FALSE, the printer starts jobs in the order that the jobs are received.

DriverName

Data type: string
Access type: Read/write

Name of the Windows printer driver.

Example: Windows NT Fax Driver

EnableBIDI

Data type: boolean
Access type: Read/write

If TRUE, the printer can print bidirectionally.

EnableDevQueryPrint

Data type: boolean
Access type: Read/write

If TRUE, the printer holds documents in the queue when document and printer setups do not match.

ErrorCleared

Data type: boolean
Access type: Read-only

If TRUE, the error reported in LastErrorCode has been cleared. This property is inherited from CIM_LogicalDevice.

ErrorDescription

Data type: string
Access type: Read-only

Information about the error recorded in LastErrorCode, and information about corrective actions that can be taken. This property is inherited from CIM_LogicalDevice.

ErrorInformation

Data type: string array
Access type: Read/write

Array of supplemental information for the current error state indicated in DetectedErrorState. This property is inherited from CIM_Printer.

ExtendedDetectedErrorState

Data type: uint16
Access type: Read-only

Reports standard error information. Additional information should be recorded in DetectedErrorState.

Values are:

Values	Meaning
0 (0x0)	Unknown
1 (0x1)	Other
2 (0x2)	No Error
3 (0x3)	Low Paper
4 (0x4)	No Paper
5 (0x5)	Low Toner
6 (0x6)	No Toner
7 (0x7)	Door Open
8 (0x8)	Jammed
9 (0x9)	Service Requested
10 (0xA)	Output Bin Full
11 (0xB)	Paper Problem
12 (0xC)	Cannot Print Page
13 (0xD)	User Intervention Required
14 (0xE)	Out of Memory
15 (0xF)	Server Unknown

ExtendedPrinterStatus

Data type: uint16
Access type: Read-only

Status information for a printer that is different from information specified in the Availability property.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	Idle
4 (0x4)	Printing
5 (0x5)	Warming Up
6 (0x6)	Stopped Printing
7	Offline
8 (0x8)	Paused
9 (0x9)	Error
10 (0xA)	Busy
11 (0xB)	Not Available
12 (0xC)	Waiting
13 (0xD)	Processing
14 (0xE)	Initialization
15	Power Save
16 (0x10)	Pending Deletion
17 (0x11)	I/O Active
18 (0x12)	Manual Feed

Hidden

Data type: boolean
Access type: Read/write

If TRUE, the printer is hidden from network users.

HorizontalResolution

Data type: uint32
Access type: Read-only

Horizontal resolution of the printer—in pixels per inch. This property is inherited from CIM_Printer.

InstallDate

Data type: datetime
Access type: Read-only

Date and time an object was installed. The object may be installed without a value being written to this property. This property is inherited from CIM_ManagedSystemElement.

JobCountSinceLastReset

Data type: uint32
Access type: Read-only

Number of print jobs since the printer was last reset. This property is inherited from CIM_Printer.

KeepPrintedJobs

Data type: boolean
Access type: Read/write

If TRUE, the print spooler does not delete the completed jobs.

LanguagesSupported

Data type: uint16 array
Access type: Read-only

Array of the print languages natively supported. This property is inherited from CIM_Printer.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	PCL
4 (0x4)	HPGL
5 (0x5)	PJL
6 (0x6)	PS
7 (0x7)	PSPrinter
8 (0x8)	IPDS
9 (0x9)	PPDS
10 (0xA)	EscapeP
11 (0xB)	Epson
12 (0xC)	DDIF
13 (0xD)	Interpress
14 (0xE)	ISO6429
15 (0xF)	LineData
16 (0x10)	DODCA
17 (0x11)	REGIS
18 (0x12)	SCS
19 (0x13)	SPDL
20 (0x14)	TEK4014
21 (0x15)	PDS
22 (0x16)	IGP
23 (0x17)	CodeV
24 (0x18)	DSCDSE
25 (0x19)	WPS
26 (0x1A)	LN03
27 (0x1B)	CCITT
28 (0x1C)	QUIC
29 (0x1D)	CPAP
30 (0x1E)	DecPPL
31 (0x1F)	SimpleText
32 (0x20)	NPAP
33 (0x21)	DOC
34 (0x22)	imPress
35 (0x23)	Pinwriter
36 (0x24)	NPDL
37 (0x25)	NEC201PL
38 (0x26)	Automatic
39 (0x27)	Pages
40 (0x28)	LIPS
41 (0x29)	TIFF
42 (0x2A)	Diagnostic
43 (0x2B)	CaPSL
44 (0x2C)	EXCL
45 (0x2D)	LCDS
46 (0x2E)	XES
47 (0x2F)	MIME
48 (0x30)	XPS
49 (0x31)	HPGL2
50 (0x32)	PCLXL

LastErrorCode

Data type: uint32
Access type: Read-only

Last error code that the logical device reports. This property is inherited from CIM_LogicalDevice.

Local

Data type: boolean
Access type: Read/write

If TRUE, the printer is not attached to a network. If both the Local and Network properties are set to TRUE, then the printer is a network printer.

Location

Data type: string
Access type: Read/write

Physical location of the printer.

Example: Bldg. 38, Room 1164

MarkingTechnology

Data type: uint16
Access type: Read-only

Marking technology the printer uses. This property is inherited from CIM_Printer.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	Electrophotographic LED
4 (0x4)	Electrophotographic Laser
5 (0x5)	Electrophotographic Other
6 (0x6)	Impact Moving Head Dot Matrix 9pin
7 (0x7)	Impact Moving Head Dot Matrix 24pin
8 (0x8)	Impact Moving Head Dot Matrix Other
9 (0x9)	Impact Moving Head Fully Formed
10 (0xA)	Impact Band
11 (0xB)	Impact Other
12 (0xC)	Inkjet Aqueous
13 (0xD)	Inkjet Solid
14 (0xE)	Inkjet Other
15 (0xF)	Pen
16 (0x10)	Thermal Transfer
17 (0x11)	Thermal Sensitive
18 (0x12)	Thermal Diffusion
19 (0x13)	Thermal Other
20 (0x14)	Electroerosion
21 (0x15)	Electrostatic
22 (0x16)	Photographic Microfiche
23 (0x17)	Photographic Imagesetter
24 (0x18)	Photographic Other
25 (0x19)	Ion Deposition
26 (0x1A)	eBeam
27 (0x1B)	Typesetter

MaxCopies

Data type: uint32
Access type: Read-only

Maximum number of copies the printer can produce for one job. This property is inherited from CIM_Printer.

MaxNumberUp

Data type: uint32
Access type: Read-only

Maximum number of print-stream pages the printer can render on one media sheet, such as paper. This property is inherited from CIM_Printer.

MaxSizeSupported

Data type: uint32
Access type: Read-only

Largest job as a byte stream, in kilobytes, that the printer can accept. A value of 0 (zero) indicates that no limit is set. This property is inherited from CIM_Printer.

MimeTypesSupported

Data type: string array
Access type: Read-only

Array of detailed MIME-type explanations that the printer supports. If data is provided, then the value 47 ("MIME") must be included in the LanguagesSupported property. This property is inherited from CIM_Printer.

Name

Data type: string
Access type: Read-only

Name of the printer.

NaturalLanguagesSupported

Data type: string array
Access type: Read-only

Array of languages supported for strings that the printer uses for output of management information. Must conform to RFC 1766. For example, "en" is used for English. This property is inherited from CIM_Printer.

Network

Data type: boolean
Access type: Read/write

If TRUE, the printer is a network printer. If both the Local and Network properties are set to TRUE, then the printer is a network printer.

PaperSizesSupported

Data type: uint16 array
Access type: Read-only

Array of the paper types that the printer supports. This property is inherited from CIM_Printer.

Value	Meaning
0	Unknown
1 (0x1)	Other
2 (0x2)	A
3 (0x3)	B
4 (0x4)	C
5 (0x5)	D
6 (0x6)	E
7 (0x7)	Letter
8 (0x8)	Legal
9 (0x9)	NA-10x13-Envelope
10 (0xA)	NA-9x12-Envelope
11 (0xB)	NA-Number-10-Envelope
12 (0xC)	NA-7x9-Envelope
13 (0xD)	NA-9x11-Envelope
14 (0xE)	NA-10x14-Envelope
15 (0xF)	NA-Number-9-Envelope
16 (0x10)	NA-6x9-Envelope
17 (0x11)	NA-10x15-Envelope
18 (0x12)	A0
19 (0x13)	A1
20 (0x14)	A2
21 (0x15)	A3
22 (0x16)	A4
23 (0x17)	A5
24 (0x18)	A6
25 (0x19)	A7
26 (0x1A)	A8
27 (0x1B)	A9A10
28 (0x1C)	B0
29 (0x1D)	B1
30 (0x1E)	B2
31 (0x1F)	B3
32 (0x20)	B4
33 (0x21)	B5
34 (0x22)	B6
35 (0x23)	B7
36 (0x24)	B8
37 (0x25)	B9
38 (0x26)	B10
39 (0x27)	C0
40 (0x28)	C1
41 (0x29)	C2
42 (0x2A)	C3
43 (0x2B)	C4
44 (0x2C)	C5
45 (0x2D)	C6
46 (0x2E)	C7
47 (0x2F)	C8
48 (0x30)	ISO-Designated
49 (0x31)	JIS B0
50 (0x32)	JIS B1
51 (0x33)	JIS B2
52 (0x34)	JIS B3
53 (0x35)	JIS B4
54 (0x36)	JIS B5
55 (0x37)	JIS B6
56 (0x38)	JIS B7
57 (0x39)	JIS B8
58 (0x3A)	JIS B9
59 (0x3B)	JIS B10

PaperTypesAvailable

Data type: string array
Access type: Read-only

Array of paper types that are currently available on the printer. Each string must be expressed in the format specified by ISO/IEC 10175 Document Printing Application (DPA), which is summarized in Appendix C of RFC 1759 (Printer MIB). Any paper size identified in this property must also appear in the PaperSizesSupported property. This property is inherited from CIM_Printer.

Example: iso-a4-colored

Parameters

Data type: string
Access type: Read/write

Optional parameters for the print processor.

Example: Copies=2

PNPDeviceID

Data type: string
Access type: Read-only

Windows Plug and Play device identifier of the logical device. This property is inherited from CIM_LogicalDevice.

Example: *PNP030b

PortName

Data type: string
Access type: Read/write

Port that is used to transmit data to a printer. If a printer is connected to more than one port, the names of each port are separated by commas. Under Windows 95, only one port can be specified.

Example: LPT1:, LPT2:, LPT3:

PowerManagementCapabilities

Data type: uint16 array
Access type: Read-only

Array of the specific power-related capabilities of a logical device. This property is inherited from CIM_LogicalDevice.

Value	Meaning
0 (0x0)	Unknown
1 (0x1)	Not Supported
2 (0x2)	Disabled
3 (0x3)	Enabled The power management features are currently enabled, but the exact feature set is unknown or the information is unavailable.
4 (0x4)	Power Saving Modes Entered Automatically The device can change its power state based on usage or other criteria.
5 (0x5)	Power State Settable The SetPowerState method is supported. This method is found on the parent CIM_LogicalDevice class and can be implemented. For more information, see Designing Managed Object Format (MOF) Classes.
6 (0x6)	Power Cycling Supported The SetPowerState method can be invoked with the PowerState parameter set to 5 (Power Cycle).
7 (0x7)	Timed Power-On Supported The SetPowerState method can be invoked with the PowerState parameter set to 5 (Power Cycle) and Time set to a specific date and time, or interval, for power-on.

PowerManagementSupported

Data type: boolean
Access type: Read-only

If TRUE, the power of the device can be managed, which means that it can be put into suspend mode. The property does not indicate that power management features are enabled, only that the logical device is capable of power management. This property is inherited from CIM_LogicalDevice.

PrinterPaperNames

Data type: string array
Access type: Read-only

Array of paper sizes supported by the printer. The printer-specified names are used to represent supported paper sizes.

Example: B5 (JIS)

PrinterState

Data type: uint32
Access type: Read-only
Qualifiers: Deprecated

One of the possible states relating to this printer. This property is obsolete. In place of this property, use PrinterStatus.

Value	Meaning
1	Paused
2	Error
3	Pending Deletion
4	Paper Jam
5	Paper Out
6	Manual Feed
7	Paper Problem
8	Offline
9	I/O Active
10	Busy
11	Printing
12	Output Bin Full
13	Not Available
14	Waiting
15	Processing
16	Initialization
17	Warming Up
18	Toner Low
19	No Toner
20	Page Punt
21	User Intervention Required
22	Out of Memory
23	Door Open
24	Server_Unknown
25	Power Save

PrinterStatus

Data type: uint16
Access type: Read-only

Status information for a printer that is different from information specified in the logical device Availability property. This property is inherited from CIM_Printer.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	Idle
4 (0x4)	Printing
5 (0x5)	Warming Up
6 (0x6)	Stopped printing
7 (0x7)	Offline

PrintJobDataType

Data type: string
Access type: Read/write

Data type of a print job waiting for the Windows-based printing device.

PrintProcessor

Data type: string
Access type: Read/write

Name of the print spooler that handles print jobs.

Example: SPOOLSS.DLL

Priority

Data type: uint32
Access type: Read/write

Priority of the printer. Jobs on a higher priority printer are scheduled first.

Published

Data type: boolean
Access type: Read/write

If TRUE, the printer is published in the network directory service.

Queued

Data type: boolean
Access type: Read/write

If TRUE, the printer buffers and queues print jobs.

RawOnly

Data type: boolean
Access type: Read/write

If TRUE, the printer accepts only raw data to be spooled.

SeparatorFile

Data type: string
Access type: Read/write

Name of the file used to create a separator page. This page is used to separate print jobs sent to the printer.

ServerName

Data type: string
Access type: Read-only

Name of the server that controls the printer. If this string is NULL, the printer is controlled locally.

Shared

Data type: boolean
Access type: Read/write

If TRUE, the printer is available as a shared network resource.

ShareName

Data type: string
Access type: Read/write

Share name of the Windows-based printing device.

Example: \\PRINTSERVER1\PRINTER2

SpoolEnabled

Data type: boolean
Access type: Read-only
Qualifiers: Deprecated

This property is obsolete; do not use. If TRUE, spooling is enabled for printer.

StartTime

Data type: datetime
Access type: Read/write

Date and time that a printer can start to print a job—if the printer is limited to print at specific times. This value is expressed as the time elapsed since 12:00 AM GMT (Greenwich Mean Time).

Status

Data type: string
Access type: Read-only
Qualifiers: MaxLen (10)

Current status of the object. Various operational and nonoperational statuses can be defined. Operational statuses include: "OK", "Degraded", and "Pred Fail" (an element, such as a SMART-enabled hard disk drive, may be functioning properly but predicting a failure in the near future). Nonoperational statuses include: "Error", "Starting", "Stopping", and "Service". The latter, "Service", could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is online, yet the managed element is neither "OK" nor in one of the other states. This property is inherited from CIM_ManagedSystemElement.

Values are:

"OK"
"Error"
"Degraded"
"Unknown"
"Pred Fail"
"Starting"
"Stopping"
"Service"
"Stressed"
"NonRecover"
"No Contact"
"Lost Comm"

StatusInfo

Data type: uint16
Access type: Read-only

State of the logical device. If this property does not apply to the logical device, the value 5 (Not Applicable) should be used. This property is inherited from CIM_LogicalDevice.

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	Enabled
4 (0x4)	Disabled
5 (0x5)	Not Applicable

SystemCreationClassName

Data type: string
Access type: Read-only
Qualifiers: Propagated

Value of the scoping computer's CreationClassName property. This property is inherited from CIM_LogicalDevice.

SystemName

Data type: string
Access type: Read-only
Qualifiers: Propagated

Name of the scoping system. This property is inherited from CIM_LogicalDevice.

TimeOfLastReset

Data type: datetime
Access type: Read-only

Date and time the printer was last reset. This property is inherited from CIM_Printer.

UntilTime

Data type: datetime
Access type: Read/write

Date and time that a printer can print the last job—if the printer is limited to print at specific times. This value is expressed as the time elapsed since 12:00 AM GMT (Greenwich Mean Time).

VerticalResolution

Data type: uint32
Access type: Read-only

Vertical resolution, in pixels-per-inch, of the printer. This property is inherited from CIM_Printer.

WorkOffline

Data type: boolean
Access type: Read/write

If TRUE, you can queue print jobs on the computer when the printer is offline.

Remarks

The Win32_Printer class is derived from CIM_Printer. Before calling SWbemObject.Put_ or IWbemServices::PutInstance for a Win32_Printer instance, the SeLoadDriverPrivilege privilege (wbemPrivilegeLoadDriver for Visual Basic and LoadDriver for scripting monikers) must be enabled. For more information, see Privilege Constants and Executing Privileged Operations. The following VBScript code example shows how to enable the SeLoadDriverPrivilege privilege in script.

Set objPrinter = GetObject( _
    "winmgmts:{impersonationLevel=Impersonate ," _
    & "(LoadDriver)}!//./root/cimv2:Win32_Printer")

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

The following VBScript code example shows how to obtain the name of the default printer for a computer.

strComputer = "."
Set objWMIService = GetObject( _
    "winmgmts:" & "{impersonationLevel=impersonate}!\\" _
    & strComputer & "\root\cimv2")
Set colInstalledPrinters =  objWMIService.ExecQuery _
    ("Select * from Win32_Printer")
For Each objPrinter in colInstalledPrinters

    If objPrinter.Default = "True" Then 
      Wscript.Echo "Name: " & objPrinter.Name
    End If
Next

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Namespace	\root\CIMV2
MOF	Cimwin32.mof
DLL	Cimwin32.dll

Community Additions

ADD