Win32_PrinterConfiguration-Klasse

Artikel
06/12/2023

Die Win32_PrinterConfigurationWMI-Klasse stellt die Konfiguration für ein Druckergerät dar. Dazu gehören Funktionen wie Auflösung, Farbe, Schriftarten und Ausrichtung.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

class Win32_PrinterConfiguration : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  uint32  BitsPerPel;
  boolean Collate;
  uint32  Color;
  uint32  Copies;
  string  DeviceName;
  uint32  DisplayFlags;
  uint32  DisplayFrequency;
  uint32  DitherType;
  uint32  DriverVersion;
  boolean Duplex;
  string  FormName;
  uint32  HorizontalResolution;
  uint32  ICMIntent;
  uint32  ICMMethod;
  uint32  LogPixels;
  uint32  MediaType;
  string  Name;
  uint32  Orientation;
  uint32  PaperLength;
  string  PaperSize;
  uint32  PaperWidth;
  uint32  PelsHeight;
  uint32  PelsWidth;
  uint32  PrintQuality;
  uint32  Scale;
  uint32  SpecificationVersion;
  uint32  TTOption;
  uint32  VerticalResolution;
  uint32  XResolution;
  uint32  YResolution;
};

Member

Die Win32_PrinterConfiguration-Klasse verfügt über folgende Membertypen:

Eigenschaften

Eigenschaften

Die Win32_PrinterConfiguration-Klasse verfügt über diese Eigenschaften.

BitsPerPel

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Veraltet

Anzahl der Bits, die verwendet werden, um die Farbe in dieser Konfiguration darzustellen (die Bits pro Pixel). Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Eigenschaften in den Klassen Win32_VideoController, Win32_DesktopMonitor oder CIM_VideoControllerResolution , um zu bestimmen, wie Farben dargestellt werden.

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64)

Kurze Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

Sortieren

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

True gibt an, dass die seiten, die gedruckt werden, sortiert werden sollten. Beim Sortieren wird das gesamte Dokument gedruckt, bevor die nächste Kopie gedruckt wird, anstatt jede Seite des Dokuments mit der erforderlichen Anzahl von Malen auszudrucken.

Diese Eigenschaft wird ignoriert, es sei denn, der Druckertreiber gibt Unterstützung für sortierung an.

Color

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Farbe des Dokuments. Einige Farbdrucker können mit echtem Schwarz anstelle einer Kombination aus Zyan, Magenta und Gelb (CMY) drucken. Dadurch wird in der Regel dunkler und schärferer Text für Dokumente erstellt. Diese Option ist nur für Farbdrucker nützlich, die echten Schwarzdruck unterstützen.

1

Monochrom (true black)

2

Color

Exemplare

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Anzahl der zu druckten Kopien. Der Druckertreiber muss das Drucken von mehrseitigen Kopien unterstützen.

Beispiel: 2

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt

Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

DeviceName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Anzeigename des Druckers. Dieser Name ist für den Druckertyp eindeutig und kann aufgrund der Einschränkungen der Zeichenfolge abgeschnitten werden, von der er abgeleitet wird.

Beispiel: "PCL/HP LaserJet"

DisplayFlags

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Gibt an, ob das Anzeigegerät farb- oder monochrom ist und ob der Scantyp nicht oder interlaced ist. Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Anzeigeeigenschaften wie die DisplayType-Eigenschaft der Win32_DesktopMonitor-Klasse .

DisplayFrequency

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Zeigt die vertikale Aktualisierungsrate an. Die Aktualisierungsrate für einen Monitor gibt an, wie oft der Bildschirm pro Sekunde neu gezeichnet wird (Häufigkeit). Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Eigenschaften in der Win32_VideoController-, Win32_DesktopMonitor- oder CIM_VideoControllerResolution-Klasse .

DitherType

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Dithertyp des Druckers. Diese Eigenschaft kann vordefinierte Werte von 1 bis 5 oder vom Treiber definierte Werte von 6 bis 256 annehmen. Line Art Dithering ist eine spezielle Ditheringmethode, die klar definierte Rahmen zwischen schwarzen, weißen und grauen Skalierungen erzeugt. Es eignet sich nicht für Bilder, die kontinuierliche Graduierungen in Intensität und Farbton enthalten, z. B. gescannte Fotografien.

Kein Dithering

Grober Pinsel

Feiner Pinsel

Linienart

Grayscale

DriverVersion

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Versionsnummer des Windows-basierten Druckertreibers. Die Versionsnummern werden vom Treiberhersteller erstellt und verwaltet.

Duplex

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

Bei TRUE erfolgt der Druck auf beiden Seiten. Bei FALSE erfolgt der Druck nur auf einer Seite des Mediums.

FormName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Wird nicht unterstützt.

HorizontalResolution

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten (Punkte pro Zoll)

Druckauflösung in Punkten pro Zoll entlang der x-Achse (Breite) des Druckauftrags (ähnlich der veralteten XResolution-Eigenschaft ). Dieser Wert wird nur festgelegt, wenn die PrintQuality-Eigenschaft dieser Klasse positiv ist.

ICMIntent

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Bestimmter Wert einer der drei möglichen Farbabgleichsmethoden (als Absichten bezeichnet), die standardmäßig verwendet werden sollen. ICM-Anwendungen richten Absichten mithilfe der ICM-Funktionen ein. Diese Eigenschaft kann vordefinierte Werte von 1 bis 3 oder vom Treiber definierte Werte von 4 bis 256 annehmen. Nicht-ICM-Anwendungen können diesen Wert verwenden, um zu bestimmen, wie der Drucker Farbdruckaufträge verarbeitet.

Sättigung

Vergleichen Sie

Genaue Farbe

ICMMethod

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Wie ICM behandelt wird. Bei einer Nicht-ICM-Anwendung bestimmt diese Eigenschaft, ob ICM aktiviert oder deaktiviert ist. Bei ICM-Anwendungen untersucht das System diese Eigenschaft, um zu bestimmen, welcher Teil des Computersystems die ICM-Unterstützung verarbeitet.

Disabled

Windows

Gerätetreiber

Sicherungsmedium

LogPixels

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Veraltet

Anzahl der Pixel pro logischem Zoll. Diese veraltete Eigenschaft ist nur für Geräte gültig, die mit Pixeln arbeiten, was Geräte wie Drucker ausschließt. Es gibt keinen Ersatzwert, der für Drucker gilt.

MediaType

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Typ des Mediums, auf dem der Drucker druckt. Die Eigenschaft kann auf einen vordefinierten Wert oder einen treiberdefinierten Wert größer oder gleich 256 festgelegt werden.

Standard

Transparenz

Glänzend

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen (256)

Name des Druckers, dem diese Konfiguration zugeordnet ist. Dieser Wert entspricht der Name-Eigenschaft des zugeordneten Win32_Printer instance.

Ausrichtung

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Druckausrichtung des Papiers.

Hochformat

Querformat

PaperLength

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten (Zehntelmillimeter)

Länge des Papiers. Um die Größe des Papiers in Zoll zu bestimmen, dividieren Sie diesen Wert durch 254.

Beispiel: 2794

Papersize

Datentyp: string
Zugriffstyp: Schreibgeschützt

Größe des Papiers. Die möglichen Größen finden Sie in der PaperSizesSupported-Eigenschaft der zugeordneten Win32_Printer-Klasse .

Beispiel: "A4 oder Buchstabe".

PaperWidth

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten (Zehntelmillimeter)

Breite des Papiers. Um die Größe des Papiers in Zoll zu bestimmen, dividieren Sie diesen Wert durch 254.

Beispiel: 2159

PelsHeight

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Veraltet

Diese Eigenschaft wird nicht unterstützt.

PelsWidth

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Veraltet

Diese Eigenschaft wird nicht unterstützt.

PrintQuality

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Eine von vier Qualitätsstufen des Druckauftrags. Wenn ein positiver Wert angegeben wird, wird die Qualität in Punkten pro Zoll gemessen.

-1

Entwurf

-2

Niedrig

-3

Medium

-4

High

Skalieren

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten (Prozent)

Faktor, um den die gedruckte Ausgabe skaliert werden soll. Beispielsweise reduziert eine Skala von 75 die Druckausgabe auf 3/4 ihrer ursprünglichen Höhe und Breite.

SettingID

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (256)

Bezeichner, unter dem das aktuelle Objekt bekannt ist.

Diese Eigenschaft wird von CIM_Setting geerbt.

SpecificationVersion

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Versionsnummer der Initialisierungsdaten für das Gerät, das dem Windows-basierten Drucker zugeordnet ist.

TTOption

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Gibt an, wie TrueType-Schriftarten gedruckt werden sollen.

Bitmap (1)

Gibt TrueType-Schriftarten als Grafiken aus. Dies ist die Standardaktion für Punktmatrixdrucker.

Herunterladen (2)

Lädt TrueType-Schriftarten als weiche Schriftarten herunter. Dies ist die Standardaktion für Drucker, die die Druckersteuerungssprache (Printer Control Language, PCL) verwenden.

Ersatz (3)

Ersetzt Geräteschriftarten durch TrueType-Schriftarten. Dies ist die Standardaktion für PostScript-Drucker.

VerticalResolution

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten (Punkte pro Zoll)

Druckauflösung entlang der y-Achse (Höhe) des Druckauftrags (ähnlich der veralteten YResolution-Eigenschaft ). Dieser Wert wird nur festgelegt, wenn die PrintQuality-Eigenschaft dieser Klasse positiv ist.

XResolution

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Veraltet

Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen die HorizontalResolution-Eigenschaft .

YResolution

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Veraltet

Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen die VerticalResolution-Eigenschaft .

Bemerkungen

Die Win32_PrinterConfiguration-Klasse wird von CIM_Setting abgeleitet.

Übersicht

Bevor Sie bestimmen können, wie Sie Ihre Druckressourcen am besten verteilen und verwenden können, müssen Sie über detaillierte Kenntnisse dieser Ressourcen verfügen. Beispielsweise verfügt Abteilung A möglicherweise nur über drei Drucker im Vergleich zu fünf Druckern in Abteilung B. Wenn die Drucker in Abteilung A jedoch 20 Seiten pro Minute drucken können und die Drucker in Abteilung B nur 5 Seiten pro Minute drucken können, haben Benutzer in Abteilung A tatsächlich mehr Druckkapazität. Ohne die detaillierten Funktionen dieser Drucker zu kennen, könnten Sie fälschlicherweise zu dem Schluss kommen, dass Abteilung A an Druckkapazität mangelt und daher zusätzliche Drucker kaufen, die am Ende ungenutzt werden.

WMI umfasst zwei Klassen, Win32_Printer und Win32_PrinterConfiguration, die verwendet werden können, um detaillierte Informationen zu allen auf einem Computer installierten Druckern zurückzugeben.

Beispiele

Im folgenden Codebeispiel werden Druckerinformationen abgerufen.

strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
 & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colInstalledPrinters = objWMIService.ExecQuery _
 ("SELECT * FROM Win32_PrinterConfiguration")
For Each objPrinter in colInstalledPrinters
 Wscript.Echo "Name: " & objPrinter.Name
 Wscript.Echo "Collate: " & objPrinter.Collate
 Wscript.Echo "Copies: " & objPrinter.Copies
 Wscript.Echo "Driver Version: " & objPrinter.DriverVersion
 Wscript.Echo "Duplex: " & objPrinter.Duplex
 Wscript.Echo "Horizontal Resolution: " & _
 objPrinter.HorizontalResolution
 If objPrinter.Orientation = 1 Then
 strOrientation = "Portrait"
 Else
 strOrientation = "Landscape"
 End If
 Wscript.Echo "Orientation : " & strOrientation
 Wscript.Echo "Paper Length: " & objPrinter.PaperLength / 254
 Wscript.Echo "Paper Width: " & objPrinter.PaperWidth / 254
 Wscript.Echo "Print Quality: " & objPrinter.PrintQuality
 Wscript.Echo "Scale: " & objPrinter.Scale
 Wscript.Echo "Specification Version: " & _
 objPrinter.SpecificationVersion
 If objPrinter.TTOption = 1 Then
 strTTOption = "Print TrueType fonts as graphics."
 ElseIf objPrinter.TTOption = 2 Then
 strTTOption = "Download TrueType fonts as soft fonts."
 Else
 strTTOption = "Substitute device fonts for TrueType fonts."
 End If
 Wscript.Echo "True Type Option: " & strTTOption
 Wscript.Echo "Vertical Resolution: " & objPrinter.VerticalResolution
Next

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Siehe auch

CIM_Setting
Hardwareklassen des Computersystems

Share via

Win32_PrinterConfiguration-Klasse

Syntax

Member

Eigenschaften

Bemerkungen

Beispiele

Anforderungen

Siehe auch

Feedback

Feedback

Zusätzliche Ressourcen