{'Description':'The Name parameter specifies a friendly name for the printer. This may be overridden if the name has alreadybeen set by the printer.','In':True,'MappingStrings':['']}
Description
'The AddPrinterConnection method provides a connection to an existing printer on the network and adds it to the list of available printers on the computer system. If successful, applications will be able to use this printer for print jobs. If unsuccessful the printer is not installed. The method can return the following values: 0 - Success. 5 - Access denied. 1801 - Invalid printer name. 1930 - Incompatible printer driver. Other - For integer values other than those listed above, refer to the documentation on the Win32 error codes.'
Implemented
True
Static
True
ValueMap
['0', '5', '1801', '1930', '..']
Values
['Success', 'Access denied', 'Invalid printer name', 'The printer driver is not compatible with a policy enabled on your computer that blocks NT 4.0 drivers', 'Other']
AddPrinterConnection method is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'The CancelAllJobs method cancels and removes all print jobs from the printer queue including the job currently printing. The method can return the following values: 0 - Success. 5 - Access denied. Other - For integer values other than those listed above, refer to the documentation on the Win32 error codes.'
Implemented
True
ValueMap
['0', '5', '..']
Values
['Success', 'Access denied', 'Other']
CancelAllJobs method is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'Retrieves a structural representation of the printer's security descriptor. The method returns an integer value that can be interpreted as follows: 0 - Successful completion. 2 - The user does not have access to the requested information. 8 - Unknown failure. 9 - The user does not have adequate privileges. 21 - The specified parameter is invalid. Other - For integer values other than those listed above, refer to Win32 error code documentation.'
'The Pause method pauses the print queue. No jobs can print anymore until the print queue is resumed. The method can return the following values: 0 - Success. 5 - Access denied. Other - For integer values other than those listed above, refer to the documentation on the Win32 error codes.'
'The PrintTestPage method prints a test page. The method can return the following values: 0 - Success. 5 - Access denied. Other - For integer values other than those listed above, refer to the documentation on the Win32 error codes.'
Implemented
True
ValueMap
['0', '5', '..']
Values
['Success', 'Access denied', 'Other']
PrintTestPage method is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
{'Description':'The NewPrinterName parameter specifies the new printer name.','In':True,'MappingStrings':['']}
Description
'The RenamePrinter method renames a printer. The method can return the following values: 0 - Success. 5 - Access denied. 1801 - Invalid printer name. Other - For integer values other than those listed above, refer to the documentation on the Win32 error codes.'
'The Resume method resumes a paused print queue. The method can return the following values: 0 - Success. 5 - Access denied. Other - For integer values other than those listed above, refer to the documentation on the Win32 error codes.'
'The SetDefaultPrinter method sets the printer to be the default printer for the user who executes the method. The method can return the following values: 0 - Success. Other - For integer values other than those listed above, refer to the documentation on the Win32 error codes.'
Implemented
True
ValueMap
['0', '..']
Values
['Success', 'Other']
SetDefaultPrinter method is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'Sets security descriptor on the printer to the specified structure. The method returns an integer value that can be interpreted as follows: 0 - Successful completion. 2 - The user does not have access to the requested information. 8 - Unknown failure. 9 - The user does not have adequate privileges. 21 - The specified parameter is invalid. Other - For integer values other than those listed above, refer to Win32 error code documentation.'
'Requests a reset of the logical device. The return value should be 0 if the request was successfully executed, 1 if the request is not supported and some other value if an error occurred.'
'SetPowerState defines the desired power state for a logical device and when a device should be put into that state. The desired power state is specified by setting the PowerState parameter to one of the following integer values: 1="Full Power", 2="Power Save - Low Power Mode", 3="Power Save - Standby", 4="Power Save - Other", 5="Power Cycle" or 6="Power Off". The Time parameter (for all state changes, except 5, "Power Cycle") indicates when the power state should be set, either as a regular date-time value or as an interval value (where the interval begins when the method invocation is received). When the PowerState parameter is equal to 5, "Power Cycle", the Time parameter indicates when the device should power on again. Power off is immediate. SetPowerState should return 0 if successful, 1 if the specified PowerState and Time request is not supported, and some other value if any other error occurred. In a subclass, the set of possible return codes could be specified, using a ValueMap qualifier on the method. The strings to which the ValueMap contents are 'translated' may also be specified in the subclass as a Values array qualifier.'
'The Attributes property indicates the attributes of the Win32 printing device. These attributes are represented through a combination of flags. Attributes of the printer include: Queued - Print jobs are buffered and queued. Direct - Specifies that the document should be sent directly to the printer. This is used if print job are not being properly queued. Default - The printer is the default printer on the computer. Shared - Available as a shared network resource. Network - Attached to the network. Hidden - Hidden from some users on the network. Local - Directly connected to this computer. EnableDevQ - Enable the queue on the printer if available. KeepPrintedJobs - Specifies that the spooler should not delete documents after they are printed. DoCompleteFirst - Start jobs that are finished spooling first. WorkOffline - Queue print jobs when printer is not available. EnableBIDI - Enable bi-directional printing. RawOnly - Allow only raw data type jobs to be spooled. Published - Indicates whether the printer is published in the network directory service. '
MappingStrings
['Win32API|Printing and Print Spooler Structures|PRINTER_INFO_2|Attributes']
'The Direct property indicates whether the print jobs should be sent directly to the printer. This means that no spool files are created for the print jobs. '
MappingStrings
['Win32API']
read
True
write
True
Direct property is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'The DoCompleteFirst property indicates whether the printer should start jobs that have finished spooling as opposed to the order of the job received.'
MappingStrings
['']
read
True
write
True
DoCompleteFirst property is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'The ExtendedDetectedErrorState property reports standard error information. Any additional information should be recorded in the DetecteErrorState property.'
'Status information for a Printer, beyond that specified in the LogicalDevice Availability property. Values include "Idle" (3) and an indication that the Device is currently printing (4).'
'The Local property indicates whether the printer is attached to the network. A masquerading printer is printer that is implemented as local printers but has a port that refers to a remote machine. From the application perspective these hybrid printers should be viewed as printer connections since that is their intended behavior.'
MappingStrings
['']
read
True
write
True
Local property is in 1 class (Win32_Printer) of ROOT\cimv2 and in 2 namespaces
'The PortName property identifies the ports that can be used to transmit data to the 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:'
MappingStrings
['Win32API|Printing and Print Spooler Structures|PRINTER_INFO_2|pPortName']
read
True
write
True
PortName property is in 1 class (Win32_Printer) of ROOT\cimv2 and in 5 namespaces
'The PrinterPaperNames property indicates the list of paper sizes supported by the printer. The printer-specified names are used to represent supported paper sizes. Example: B5 (JIS).'
MappingStrings
['Win32API|Printing and Print Spooler Structures|DeviceCapabilities|DC_PAPERNAMES']
read
True
PrinterPaperNames property is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'This property has been deprecated in favor of PrinterStatus, DetectedErrorState and ErrorInformation CIM properties that more clearly indicate the state and error status of the printer. The PrinterState property specifies a values indicating one of the possible states relating to this printer.'
MappingStrings
['Win32API|Printing and Print Spooler Structures|PRINTER_INFO_6|dwStatus']
'The SeparatorFile property specifies the name of the file used to create a separator page. This page is used to separate print jobs sent to the printer.'
MappingStrings
['Win32API|Printing and Print Spooler Structures|PRINTER_INFO_2|pSepFile']
read
True
write
True
SeparatorFile property is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'The SpoolEnabled property shows whether spooling is enabled for this printer. Values:TRUE or FALSE. The SpoolEnabled property has been deprecated. There is no replacementvalue and this property is now considered obsolete.'
MappingStrings
['Win32API|Printing and Print Spooler Structures|PRINTER_INFO_2|Attributes']
read
True
SpoolEnabled property is in 1 class (Win32_Printer) of ROOT\cimv2 and in 1 namespace
'The StartTime property specifies the earliest time the printer can print a job (if the printer has been limited to print only at certain times). This value is expressed as time elapsed since 12:00 AM GMT (Greenwich mean time).'
MappingStrings
['Win32API|Printing and Print Spooler Structures|PRINTER_INFO_2|StartTime']
'The UntilTime property specifies the latest time the printer can print a job (if the printer has been limited to print only at certain times). This value is expressed as time elapsed since 12:00 AM GMT (Greenwich mean time).'
MappingStrings
['Win32API|Printing and Print Spooler Structures|PRINTER_INFO_2|UntilTime']
'The availability and status of the device. For example, the Availability property indicates that the device is running and has full power (value=3), or is in a warning (4), test (5), degraded (10) or power save state (values 13-15 and 17). Regarding the power saving states, these are defined as follows: Value 13 ("Power Save - Unknown") indicates that the device is known to be in a power save mode, but its exact status in this mode is unknown; 14 ("Power Save - Low Power Mode") indicates that the device is in a power save state but still functioning, and may exhibit degraded performance; 15 ("Power Save - Standby") describes that the device is not functioning but could be brought to full power 'quickly'; and value 17 ("Power Save - Warning") indicates that the device is in a warning state, though also in a power save mode.'
'Describes all of the job sheets that are available on the Printer. This can also be used to describe the banner that a Printer might provide at the beginning of each Job, or can describe other user specified options.'
'An array of integers indicating Printer capabilities. Information such as "Duplex Printing" (value=3) or "Transparency Printing" (7) is specified in this property.'
'An array of free-form strings providing more detailed explanations for any of the Printer features indicated in the Capabilities array. Note, each entry of this array is related to the entry in the Capabilities array that is located at the same index.'
'Identifies the available character sets for the output of text related to managing the Printer. Strings provided in this property should conform to the semantics and syntax specified by section 4.1.2 ("Charset parameter") in RFC 2046 (MIME Part 2) and contained in the IANA character-set registry. Examples include "utf-8", "us-ascii" and "iso-8859-1".'
'Indicates the Win32 Configuration Manager error code. The following values may be returned: 0 This device is working properly. 1 This device is not configured correctly. 2 Windows cannot load the driver for this device. 3 The driver for this device might be corrupted, or your system may be running low on memory or other resources. 4 This device is not working properly. One of its drivers or your registry might be corrupted. 5 The driver for this device needs a resource that Windows cannot manage. 6 The boot configuration for this device conflicts with other devices. 7 Cannot filter. 8 The driver loader for the device is missing. 9 This device is not working properly because the controlling firmware is reporting the resources for the device incorrectly. 10 This device cannot start. 11 This device failed. 12 This device cannot find enough free resources that it can use. 13 Windows cannot verify this device's resources. 14 This device cannot work properly until you restart your computer. 15 This device is not working properly because there is probably a re-enumeration problem. 16 Windows cannot identify all the resources this device uses. 17 This device is asking for an unknown resource type. 18 Reinstall the drivers for this device. 19 Your registry might be corrupted. 20 Failure using the VxD loader. 21 System failure: Try changing the driver for this device. If that does not work, see your hardware documentation. Windows is removing this device. 22 This device is disabled. 23 System failure: Try changing the driver for this device. If that doesn't work, see your hardware documentation. 24 This device is not present, is not working properly, or does not have all its drivers installed. 25 Windows is still setting up this device. 26 Windows is still setting up this device. 27 This device does not have valid log configuration. 28 The drivers for this device are not installed. 29 This device is disabled because the firmware of the device did not give it the required resources. 30 This device is using an Interrupt Request (IRQ) resource that another device is using. 31 This device is not working properly because Windows cannot load the drivers required for this device.'
['This device is working properly.', 'This device is not configured correctly.', 'Windows cannot load the driver for this device.', 'The driver for this device might be corrupted, or your system may be running low on memory or other resources.', 'This device is not working properly. One of its drivers or your registry might be corrupted.', 'The driver for this device needs a resource that Windows cannot manage.', 'The boot configuration for this device conflicts with other devices.', 'Cannot filter.', 'The driver loader for the device is missing.', 'This device is not working properly because the controlling firmware is reporting the resources for the device incorrectly.', 'This device cannot start.', 'This device failed.', 'This device cannot find enough free resources that it can use.', 'Windows cannot verify this device's resources.', 'This device cannot work properly until you restart your computer.', 'This device is not working properly because there is probably a re-enumeration problem.', 'Windows cannot identify all the resources this device uses.', 'This device is asking for an unknown resource type.', 'Reinstall the drivers for this device.', 'Failure using the VxD loader.', 'Your registry might be corrupted.', 'System failure: Try changing the driver for this device. If that does not work, see your hardware documentation. Windows is removing this device.', 'This device is disabled.', 'System failure: Try changing the driver for this device. If that doesn't work, see your hardware documentation.', 'This device is not present, is not working properly, or does not have all its drivers installed.', 'Windows is still setting up this device.', 'Windows is still setting up this device.', 'This device does not have valid log configuration.', 'The drivers for this device are not installed.', 'This device is disabled because the firmware of the device did not give it the required resources.', 'This device is using an Interrupt Request (IRQ) resource that another device is using.', 'This device is not working properly because Windows cannot load the drivers required for this device.']
'CreationClassName indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.'
'Specifies which finishings and other capabilities of the Printer are currently being used. An entry in this property should also be listed in the Capabilities array.'
ModelCorrespondence
['CIM_Printer.Capabilities']
read
True
Values
['Unknown', 'Other', 'Color Printing', 'Duplex Printing', 'Copies', 'Collation', 'Stapling', 'Transparency Printing', 'Punch', 'Cover', 'Bind', 'Black and White Printing', 'One Sided', 'Two Sided Long Edge', 'Two Sided Short Edge', 'Portrait', 'Landscape', 'Reverse Portrait', 'Reverse Landscape', 'Quality High', 'Quality Normal', 'Quality Low']
'Specifies the current character set being used for the output of text relating to management of the Printer. The character set described by this property should also be listed in CharsetsSupported. The string specified by this property should conform to the semantics and syntax specified by section 4.1.2 ("Charset parameter") in RFC 2046 (MIME Part 2) and contained in the IANA character-set registry. Examples include "utf-8", "us-ascii" and "iso-8859-1".'
'Identifies the current language being used by the Printer for management. The language listed in the CurrentNaturalLanguage property should also be listed in NaturalLanguagesSupported.'
'Specifies the paper type that the Printer is currently using. The string should be expressed in the form specified by ISO/IEC 10175 Document Printing Application (DPA) which is also summarized in Appendix C of RFC 1759 (Printer MIB).'
'Specifies which finishings and other capabilities of the Printer will be used by default. An entry in DefaultCapabilities should also be listed in the Capabilities array.'
ModelCorrespondence
['CIM_Printer.Capabilities']
read
True
Values
['Unknown', 'Other', 'Color Printing', 'Duplex Printing', 'Copies', 'Collation', 'Stapling', 'Transparency Printing', 'Punch', 'Cover', 'Bind', 'Black and White Printing', 'One Sided', 'Two Sided Long Edge', 'Two Sided Short Edge', 'Portrait', 'Landscape', 'Reverse Portrait', 'Reverse Landscape', 'Quality High', 'Quality Normal', 'Quality Low']
'Specifies the paper type that the Printer will use if a PrintJob does not specify a particular type. The string should be expressed in the form specified by ISO/IEC 10175 Document Printing Application (DPA) which is also summarized in Appendix C of RFC 1759 (Printer MIB).'
'ErrorDescription is a free-form string supplying more information about the error recorded in LastErrorCode property, and information on any corrective actions that may be taken.'
'The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.'
'An array of free-form strings providing more detailed explanations of any mime types that are supported by the Printer. If data is provided for this property, then the value 47, "Mime", should be included in the LanguagesSupported property.'
'Identifies the available languages for strings used by the Printer for the output of management information. The strings should conform to RFC 1766, for example "en" is used for English.'
'An array of free-form strings specifying the types of paper that are currently available on the Printer. Each string should be expressed in the form specified by ISO/IEC 10175 Document Printing Application (DPA) which is also summarized in Appendix C of RFC 1759 (Printer MIB). Examples of valid strings are "iso-a4-colored" and "na-10x14-envelope". By definition a paper size that is available and listed in PaperTypesAvailable should also appear in the PaperSizesSupported property.'
'Indicates the specific power-related capabilities of the logical device. The array values, 0="Unknown", 1="Not Supported" and 2="Disabled" are self-explanatory. The value, 3="Enabled" indicates that the power management features are currently enabled but the exact feature set is unknown or the information is unavailable. "Power Saving Modes Entered Automatically" (4) describes that a device can change its power state based on usage or other criteria. "Power State Settable" (5) indicates that the SetPowerState method is supported. "Power Cycling Supported" (6) indicates that the SetPowerState method can be invoked with the PowerState input variable set to 5 ("Power Cycle"). "Timed Power On Supported" (7) indicates that the SetPowerState method can be invoked with the PowerState input variable set to 5 ("Power Cycle") and the Time parameter set to a specific date and time, or interval, for power-on.'
read
True
Values
['Unknown', 'Not Supported', 'Disabled', 'Enabled', 'Power Saving Modes Entered Automatically', 'Power State Settable', 'Power Cycling Supported', 'Timed Power On Supported']
'Boolean indicating that the Device can be power managed - ie, put into a power save state. This boolean does not indicate that power management features are currently enabled, or if enabled, what features are supported. Refer to the PowerManagementCapabilities array for this information. If this boolean is false, the integer value 1, for the string, "Not Supported", should be the only entry in the PowerManagementCapabilities array.'
'Status information for a Printer, beyond that specified in the LogicalDevice Availability property. Values include "Idle" (3) and an indication that the Device is currently printing (4).'
'The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are "OK", "Degraded" and "Pred Fail". "Pred Fail" indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are "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 on-line, yet the managed element is neither "OK" nor in one of the other states.'
'StatusInfo is a string indicating whether the logical device is in an enabled (value = 3), disabled (value = 4) or some other (1) or unknown (2) state. If this property does not apply to the logical device, the value, 5 ("Not Applicable"), should be used.'