Export (0) Print
Expand All
34 out of 47 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

The Win32_Printer class has these methods.

MethodDescription
AddPrinterConnection

Adds a connection to the printer.

CancelAllJobs

Cancels all jobs.

GetSecurityDescriptor

Returns the security descriptor that controls access to the printer. This method is available starting with Windows Vista.

Windows Server 2003 and Windows XP:  This method is not available.

Pause

Pauses the print queue.

PrintTestPage

Prints a test page.

RenamePrinter

Renames a printer.

Reset

Not implemented. For more information about how to implement this method, see the Reset method in CIM_Printer.

Resume

Resumes paused print queue.

SetDefaultPrinter

Sets the default printer.

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 and Windows XP:  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 bitMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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 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:

ValuesMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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.

ValueMeaning
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 XP

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Computer System Hardware Classes

 

 

Show:
© 2014 Microsoft. All rights reserved.