Win32_Printer Class (Windows)

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.


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;
};

Methods

The Win32_Printer class defines the following 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.
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.
SetPowerState	Not implemented. For more information about how to implement this method, see the SetPowerState method in CIM_Printer.

Properties

The Win32_Printer class defines the following 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")

Example Code

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.

Example Code [VBScript]

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

Client	Requires Windows Vista, Windows XP, or Windows NT Workstation 4.0.
Server	Requires Windows Server 2008, Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
MOF	Declared in Cimwin32.mof.
DLL	Requires Cimwin32.dll.
Namespace	Defined in \root\cimv2.

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Methods

Properties

Remarks

Example Code

Example Code [VBScript]

Requirements

See Also