Win32_PrintJob-Klasse

Artikel
06/12/2023

Die Win32_PrintJobWMI-Klasse stellt einen Druckauftrag dar, der von einer Windows-Anwendung generiert wird. Jede Arbeitseinheit, die vom Druckbefehl einer Anwendung generiert wird, die auf einem Computer unter einem Windows-Betriebssystem ausgeführt wird, ist ein Nachfolger oder Mitglied dieser Klasse.

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_PrintJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   JobStatus;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime StartTime;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Color;
  string   DataType;
  string   Document;
  string   DriverName;
  string   HostPrintQueue;
  uint32   JobId;
  uint32   PagesPrinted;
  uint32   PaperLength;
  string   PaperSize;
  uint32   PaperWidth;
  string   Parameters;
  string   PrintProcessor;
  uint32   Size;
  uint32   StatusMask;
  uint32   TotalPages;
};

Member

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

Methoden
Eigenschaften

Methoden

Die Win32_PrintJob-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
Anhalten	Hält einen Druckauftrag an.
Fortsetzen	Setzt einen Druckauftrag fort.

Eigenschaften

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

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), DisplayName ("Caption")

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Color

Datentyp: string
Zugriffstyp: Schreibgeschützt

Zeichenfolge, die angibt, ob das Dokument in Farbe oder monochrom gedruckt wird. Einige Farbdrucker haben die Möglichkeit, anstelle einer Kombination aus Gelb, Zyan und Magenta mit True Schwarz zu drucken. True Schwarz 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.

Die Werte sind:

"Farbe"
"Monochrom"

DataType

Datentyp: string
Zugriffstyp: Schreibgeschützt

Format der Daten für diesen Druckauftrag. Dadurch wird der Druckertreiber angewiesen, die Daten (generischer Text, PostScript oder PCL) vor dem Drucken zu übersetzen oder in einem Rohformat (für Grafiken und Bilder) zu drucken.

Beispiel: "TEXT"

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Document

Datentyp: string
Zugriffstyp: Schreibgeschützt

Name des Druckauftrags. Der Benutzer sieht diesen Namen beim Anzeigen von Dokumenten, die darauf warten, gedruckt zu werden.

Beispiel: "Microsoft Word – Review.doc"

DriverName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Name des Druckertreibers, der für den Druckauftrag verwendet wird.

ElapsedTime

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Dauer der Ausführung des Auftrags.

Diese Eigenschaft wird von CIM_Job geerbt.

HostPrintQueue

Datentyp: string
Zugriffstyp: Schreibgeschützt

Name des Computers, auf dem der Druckauftrag erstellt wird.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Jobid

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Bezeichnernummer des Auftrags. Es wird von anderen Methoden als Handle für einen Auftrag verwendet, der mit dem Drucker gepoolt wird.

Auftragsstatus

Datentyp: string
Zugriffstyp: Schreibgeschützt

Freiformzeichenfolge, die den Auftrag status darstellt.

Diese Eigenschaft wird von CIM_Job geerbt.

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Name")

Bezeichnung, unter der das Objekt bekannt ist. Bei unterklassigen Klassen kann diese Eigenschaft als Schlüsseleigenschaft überschrieben werden.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Benachrichtigen

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Benutzer wird benachrichtigt, wenn der Auftrag abgeschlossen oder fehlgeschlagen ist.

Diese Eigenschaft wird von CIM_Job geerbt.

Besitzer

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Benutzer, der den Auftrag übermittelt hat.

Diese Eigenschaft wird von CIM_Job geerbt.

PagesPrinted

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Anzahl der gedruckten Seiten. Dieser Wert kann 0 (null) sein, wenn der Druckauftrag keine seitentrennenden Informationen enthält.

PaperLength

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

Länge des Papiers.

Beispiel: 2794

Papersize

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Größe des Papiers, das zum Drucken des Auftrags verwendet wird. Der Wert ist eine der möglichen Papiergrößen für den Drucker, der in der PaperSizesSupported-EigenschaftWin32_Printer Klasse angegeben ist.

PaperWidth

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

Breite des Papiers.

Beispiel: 2159

Parameter

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Optionale Parameter, die an den Druckprozessor gesendet werden sollen. Weitere Informationen finden Sie in der PrintProcessor-Eigenschaft .

Printprocessor

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Druckprozessordienst, der zur Verarbeitung des Druckauftrags verwendet wird. Ein Druckerprozessor arbeitet in Verbindung mit dem Druckertreiber, um zusätzliche Übersetzungen von Druckerdaten für den Drucker bereitzustellen, und kann auch verwendet werden, um spezielle Optionen bereitzustellen, z. B. eine Titelseite für den Auftrag.

Priority

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Bedeutung der Ausführung eines Auftrags.

Diese Eigenschaft wird von CIM_Job geerbt.

Größe

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

Größe des Druckauftrags.

StartTime

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Zeitpunkt, zu dem der Auftrag begonnen hat.

Diese Eigenschaft wird von CIM_Job geerbt.

Status

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (10), DisplayName ("Status")

Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).

Nicht betriebsbereite status können "Error", "Starting", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

StatusMask

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Bitmap der möglichen Status, die sich auf diesen Druckauftrag beziehen.

1 (0x1)

Angehalten

2 (0x2)

Fehler

4 (0x4)

Wird gelöscht

8 (0x8)

Spooling

16 (0x10)

Drucken

32 (0x20)

Offline

64 (0x40)

Paperout

128 (0x80)

Gedruckt

256 (0x100)

Deleted

512 (0x200)

Blocked_DevQ

1024 (0x400)

User_Intervention_Req

2048 (0x800)

Neu starten

TimeSubmitted

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Zeitpunkt, zu dem der Auftrag übermittelt wurde.

Diese Eigenschaft wird von CIM_Job geerbt.

TotalPages

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Anzahl der zum Abschluss des Auftrags erforderlichen Seiten. Dieser Wert kann 0 (null) sein, wenn der Druckauftrag keine seitentrennenden Informationen enthält.

UntilTime

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Zeitpunkt, zu dem der Auftrag ungültig ist oder beendet werden soll.

Diese Eigenschaft wird von CIM_Job geerbt.

Bemerkungen

Die Win32_PrintJob-Klasse wird von CIM_Job abgeleitet.

Beispiele

Im folgenden VBScript-Codebeispiel wird beschrieben, wie Druckerauftragsstatistiken aus Instanzen von Win32_PrintJob abgerufen werden.

Set PrintJobSet = GetObject("winmgmts:").InstancesOf ("Win32_PrintJob")

If (PrintJobSet.Count = 0) Then WScript.Echo "No print jobs!"
for each PrintJob in PrintJobSet
 WScript.Echo PrintJob.Name
 WScript.Echo PrintJob.JobId
 WScript.Echo PrintJob.Status
 WScript.Echo PrintJob.TotalPages
 Wscript.Echo ""
next

Im folgenden Perl-Codebeispiel wird beschrieben, wie Druckerauftragsstatistiken aus Instanzen von Win32_PrintJob abgerufen werden.

use strict;
use Win32::OLE;

close (STDERR);

my ($PrintJobset, $PrintJob);
eval {$PrintJobset = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}")->
 InstancesOf ("Win32_PrintJob") };
if (!$@ && defined $PrintJobset)
{
 if ($PrintJobset->{Count} == 0 ) 
 {
  print "\nNo print jobs!\n";
 }

 foreach $PrintJob (in $PrintJobset)
 {
  print $PrintJob->{Name} , "\n";
  print $PrintJob->{JobId} , "\n";
  print $PrintJob->{Status} , "\n";
  print $PrintJob->{TotalPages} , "\n";
 }
}
else
{
 print Win32::OLE->LastError, "\n";
}

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_Job
Hardwareklassen des Computersystems

Freigeben über

Win32_PrintJob-Klasse

Syntax

Member

Methoden

Eigenschaften

Bemerkungen

Beispiele

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen