Win32 _ PrinterConfiguration-Klasse

Die WMI-Klasse _ Win32 PrinterConfiguration 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 die folgenden Membertypen:

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 (die Bits pro Pixel) darstellen. Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Eigenschaften in den Klassen Win32 _ VideoController, Win32 _ DesktopMonitoroder CIM _ VideoControllerResolution, um zu bestimmen, wie Farbe dargestellt wird.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64)

Kurze Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von der CIM-Einstellung _ geerbt.

Sortieren

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

True gibt an, dass die seiten, die gedruckt werden, sortiert werden sollen. Die Sortierung besteht im Drucken des gesamten Dokuments vor dem Drucken der nächsten Kopie, anstatt jede Seite des Dokuments so oft wie erforderlich ausdrucken zu müssen.

Diese Eigenschaft wird ignoriert, es sei denn, der Druckertreiber gibt unterstützung für die Sortierung an.

Farbe

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Farbe des Dokuments. Einige Farbdrucker können mit echtem Schwarz statt einer Kombination aus Cyan, Magenta und Gelb (CMY) drucken. Dies erzeugt in der Regel dunkleren und schärferen Text für Dokumente. Diese Option ist nur für Farbdrucker nützlich, die echten Schwarzdruck unterstützen.

1

Monofarbig (true black)

2

Color

Exemplare

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Anzahl der zu druckenden Kopien. Der Druckertreiber muss das Drucken von Mehrseitenkopien unterstützen.

Beispiel: 2

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Textbeschreibung des aktuellen -Objekts.

Diese Eigenschaft wird von der CIM-Einstellung _ geerbt.

Devicename

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Beispiel: "PCL/HPLasJet"

DisplayFlags

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob das Anzeigegerät farblich oder monofarbig ist und ob der Typ der Überprüfung nicht geschachtelt oder verschachtelt 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 ist die Häufigkeit, mit der der Bildschirm pro Sekunde neu gezeichnet wird (Häufigkeit). Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Eigenschaften in der Klasse Win32 _ VideoController, Win32 _ DesktopMonitoroder CIM _ VideoControllerResolution.

DitherType

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Dithertyp des Druckers. Diese Eigenschaft kann vordefinierte Werte von 1 bis 5 oder treiberdefinierte Werte von 6 bis 256 annehmen. Line Art Dithering ist eine spezielle Ditheringmethode, die klar definierte Rahmen zwischen schwarzer, weißer und grauer Skalierung erzeugt. Es eignet sich nicht für Bilder, die kontinuierliche Intensität und Farbton enthalten, z. B. gescannte Fotos.

1

Kein Dithering

2

Grober Pinsel

3

Fine Brush

4

Linienart

5

Grayscale

DriverVersion

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

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

Duplex

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

True gibt an, dass der Druck auf beiden Seiten erfolgt. False gibt an, dass das Drucken nur auf einer Seite des Mediums erfolgt.

FormName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Wird nicht unterstützt.

HorizontalResolution

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten (Punkte pro Zoll)

Druckauflösung in Punkt 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 erstellen Absichten mithilfe der ICM Funktionen. Diese Eigenschaft kann vordefinierte Werte von 1 bis 3 oder treiberdefinierte Werte von 4 bis 256 annehmen. Nicht-ICM können diesen Wert verwenden, um zu bestimmen, wie der Drucker Farbdruckaufträge verarbeitet.

1

Sättigung

2

Vergleichen Sie

3

Genaue Farbe

ICMMethod

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Wie ICM behandelt wird. Bei anwendungen, die ICM, bestimmt diese Eigenschaft, ob ICM aktiviert oder deaktiviert ist. Bei ICM untersucht das System diese Eigenschaft, um zu bestimmen, welcher Teil des Computersystems die ICM verarbeitet.

1

Disabled

2

Windows

3

Gerätetreiber

4

Gerät

LogPixels

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Veraltet

Anzahl von Pixeln pro logischem Zoll. Diese veraltete Eigenschaft ist nur für Geräte gültig, die mit Pixeln arbeiten, wodurch Geräte wie Drucker ausgeschlossen werden. Es gibt keinen Ersatzwert, der für Drucker gilt.

MediaType

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Medientyp, auf dem der Drucker gedruckt wird. Die -Eigenschaft kann auf einen vordefinierten Wert oder einen vom Treiber definierten Wert größer oder gleich 256 festgelegt werden.

1

Standard

2

Transparenz

3

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 der zugeordneten Win32-Druckerinstanz. _

Orientation

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Druckausrichtung des Papiers.

1

Hochformat

2

Querformat

PaperLength

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten (Zehntel eines Millimeters)

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

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 (Zehntel eines Millimeters)

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

Beispiel: 2159

IgkeitenHeight

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Veraltet

Diese Eigenschaft wird nicht unterstützt.

Beswidth

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 Punkt pro Zoll gemessen.

-1

Entwurf

-2

Niedrig

-3

Medium

-4

Hoch

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 der CIM-Einstellung _ geerbt.

SpecificationVersion

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

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

TTOption

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, wie TrueType-Schriftarten gedruckt werden sollen.

Bitmap (1)

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

Herunterladen (2)

Lädt TrueType-Schriftarten als Softfonts herunter. Dies ist die Standardaktion für Drucker, die die Druckersteuerungssprache (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.

Hinweise

Die Win32 _ PrinterConfiguration-Klasse wird von der _ CIM-Einstellung abgeleitet.

Übersicht

Bevor Sie bestimmen können, wie Sie Ihre Druckressourcen am besten verteilen und verwenden können, müssen Sie über ausführliche Kenntnisse dieser Ressourcen verfügen. Beispielsweise kann Abteilung A im Vergleich zu fünf Druckern in Abteilung B nur drei Drucker haben. 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, verfügen Benutzer in Abteilung A tatsächlich über mehr Druckkapazität. Ohne die detaillierten Funktionen dieser Drucker zu kennen, können Sie fälschlicherweise zu dem Schluss kommen, dass Abteilung A nicht über die Druckkapazität verfügt, und daher zusätzliche Drucker erwerben, die ungenutzt werden.

WMI enthält zwei Klassen, Win32 _ Printer und Win32 _ PrinterConfiguration, die verwendet werden können, um ausführliche Informationen zu allen druckern zurück, die auf einem Computer installiert sind.

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)
Windows Server 2008
Namespace
\Stamm-CIMV2
MOF
Win32 _ Printer.mof
DLL
CIMWin32.dll

Weitere Informationen

_CIM-Einstellung

Hardwareklassen des Computersystems