JOB _ INFO _ 1-Struktur

Die Job _ INFO _ 1-Struktur gibt Druckauftragsinformationen an, z. B. den Auftragsbezeichnerwert, den Namen des Druckers, für den der Auftrag gespoolt wird, den Namen des Computers, der den Druckauftrag erstellt hat, den Namen des Benutzers, der den Druckauftrag besitzt usw.

Syntax

typedef struct _JOB_INFO_1 {
  DWORD      JobId;
  LPTSTR     pPrinterName;
  LPTSTR     pMachineName;
  LPTSTR     pUserName;
  LPTSTR     pDocument;
  LPTSTR     pDatatype;
  LPTSTR     pStatus;
  DWORD      Status;
  DWORD      Priority;
  DWORD      Position;
  DWORD      TotalPages;
  DWORD      PagesPrinted;
  SYSTEMTIME Submitted;
} JOB_INFO_1, *PJOB_INFO_1;

Members

Jobid

Ein Auftragsbezeichner.

pPrinterName

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Druckers angibt, für den der Auftrag gespoolt wird.

pMachineName

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Computers angibt, der den Druckauftrag erstellt hat.

pUserName

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Benutzers angibt, der den Druckauftrag besitzt.

pDocument

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Druckauftrags angibt (z. B. "MS-WORD: Review.doc").

pDatatype

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Datentyp angibt, der zum Aufzeichnen des Druckauftrags verwendet wird.

pStatus

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Status des Druckauftrags angibt. Dieser Member sollte vor Status überprüft werden. Wenn pStatus NULL ist, wird der Status durch den Inhalt des Statusmembers definiert.

Status

Der Auftragsstatus. Der Wert dieses Members kann 0 (null) oder eine Kombination aus einem oder mehreren der folgenden Werte sein. Der Wert 0 (null) gibt an, dass die Druckwarteschlange angehalten wurde, nachdem das Spooling des Dokuments abgeschlossen wurde.

Wert Bedeutung
_ _ AUFTRAGSSTATUS BLOCKIERT _ DEVQ Der Treiber kann den Auftrag nicht drucken.
AUFTRAGSSTATUS _ _ ABGESCHLOSSEN Windows XP und höher: Der Auftrag wird an den Drucker gesendet, aber der Auftrag ist möglicherweise noch nicht gedruckt.
Weitere Informationen finden Sie unter Hinweise.
AUFTRAGSSTATUS _ _ GELÖSCHT Der Auftrag wurde gelöscht.
_LÖSCHEN DES AUFTRAGSSTATUS _ Der Auftrag wird gelöscht.
_ _ AUFTRAGSSTATUSFEHLER Dem Auftrag wird ein Fehler zugeordnet.
AUFTRAGSSTATUS _ _ OFFLINE Der Drucker ist offline.
JOB _ STATUS _ PAPEROUT Der Drucker ist nicht mehr auf Papier.
AUFTRAGSSTATUS _ _ ANGEHALTEN Der Auftrag wird angehalten.
AUFTRAGSSTATUS _ _ GEDRUCKT Der Auftrag wurde gedruckt.
_DRUCKEN DES AUFTRAGSSTATUS _ Der Auftrag wird gedruckt.
_ _ AUFTRAGSSTATUSNEUSTART Der Auftrag wurde neu gestartet.
AUFTRAGSSTATUS _ _ BEIBEHALTEN Windows Vista und höher: Der Auftrag wurde in der Druckwarteschlange beibehalten und kann nicht gelöscht werden. Dies kann folgende Ursachen haben:
1) Der Auftrag wurde manuell durch einen Aufruf von SetJob beibehalten, und der Spooler wartet darauf, dass der Auftrag freigegeben wird.
2) Der Auftrag hat den Druck nicht abgeschlossen und muss den Druckvorgang abschließen, bevor er automatisch gelöscht werden kann.
Weitere Informationen zu Druckauftragsbefehlen finden Sie unter SetJob.
_ _ AUFTRAGSSTATUSSPOOLING Der Auftrag wird gespoolt.
_BENUTZEREINGRIFF BEIM AUFTRAGSSTATUS _ _ Der Drucker weist einen Fehler auf, der erfordert, dass der Benutzer etwas tut.

Priority

Die Auftragspriorität. Dieser Member kann einer der folgenden Werte oder im Bereich zwischen 1 und 99 (MIN _ PRIORITY bis MAX _ PRIORITY) sein.

Wert Bedeutung
MIN _ PRIORITY Mindestpriorität.
MAX _ PRIORITY Maximale Priorität.
DEF _ PRIORITY Standardpriorität.

Position

Die Position des Auftrags in der Druckwarteschlange.

TotalPages

Die Gesamtanzahl der Seiten, die das Dokument enthält. Dieser Wert kann 0 (null) sein, wenn der Druckauftrag keine Seitentrenninformationen enthält.

PagesPrinted

Die Anzahl der seiten, die gedruckt wurden. Dieser Wert kann 0 (null) sein, wenn der Druckauftrag keine Seitentrenninformationen enthält.

Gesendet

Eine SYSTEMTIME-Struktur, die den Zeitpunkt angibt, zu dem dieses Dokument gespoolt wurde.

Dieser Zeitwert liegt im UTC-Format (Universal Time Coordinate) vor. Sie sollten ihn in einen Ortszeitwert konvertieren, bevor Sie ihn anzeigen. Sie können die FileTimeToLocalFileTime-Funktion verwenden, um die Konvertierung durchzuführen.

Bemerkungen

Portmonitore, die TrueEndOfJob nicht unterstützen, legen den Auftrag direkt nach der Übermittlung des Auftrags an den Drucker als _ AUFTRAGSSTATUS _ GEDRUCKT fest.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Winspool.h (include Windows.h)
Unicode- und ANSI-Name
_ JOB _ INFO _ 1W (Unicode) und _ JOB INFO _ _ 1A (ANSI)

Weitere Informationen

Drucken

Drucken von Spooler-API-Strukturen

EnumJobs

GetJob

SetJob