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;

Member

Jobid

Ein Auftragsbezeichner.

pPrinterName

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

pMachineName

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

pUserName

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

pDocument

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

pDatatype

Ein Zeiger auf eine NULL-Zeichenfolge, die den Typ der Daten angibt, die zum Aufzeichnen des Druckauftrags verwendet werden.

pStatus

Ein Zeiger auf eine NULL-Zeichenfolge, die die status des Druckauftrags angibt. Dieser Member sollte vor Status überprüft werden, und wenn pStatusNULL ist, wird die status durch den Inhalt des Statuselements definiert.

Status

Der Auftrag status. Der Wert dieses Members kann null oder eine Kombination aus mindestens einem der folgenden Werte sein. Der Wert null gibt an, dass die Druckwarteschlange angehalten wurde, nachdem das Dokument die Spooling abgeschlossen hat.

Wert	Bedeutung
JOB_STATUS_BLOCKED_DEVQ	Der Treiber kann den Auftrag nicht drucken.
JOB_STATUS_COMPLETE	Windows XP und höher: Auftrag wird an den Drucker gesendet, aber der Auftrag wurde möglicherweise noch nicht gedruckt. Weitere Informationen finden Sie unter Hinweise.
JOB_STATUS_DELETED	Der Auftrag wurde gelöscht.
JOB_STATUS_DELETING	Der Auftrag wird gelöscht.
JOB_STATUS_ERROR	Dem Auftrag ist ein Fehler zugeordnet.
JOB_STATUS_OFFLINE	Der Drucker ist offline.
JOB_STATUS_PAPEROUT	Der Drucker ist kein Papier.
JOB_STATUS_PAUSED	Der Auftrag wird angehalten.
JOB_STATUS_PRINTED	Auftrag wurde gedruckt.
JOB_STATUS_PRINTING	Der Auftrag wird gedruckt.
JOB_STATUS_RESTART	Der Auftrag wurde neu gestartet.
JOB_STATUS_RETAINED	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 auf die Freigabe des Auftrags. 2) Der Auftrag hat den Druck noch nicht abgeschlossen und muss den Druck abschließen, bevor er automatisch gelöscht werden kann. Weitere Informationen zu Druckauftragsbefehlen finden Sie unter SetJob .
JOB_STATUS_SPOOLING	Auftrag ist Spooling.
JOB_STATUS_USER_INTERVENTION	Der Drucker weist einen Fehler auf, der erfordert, dass der Benutzer etwas tun muss.

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 sein, wenn der Druckauftrag keine Seitentrennzeicheninformationen enthält.

PagesPrinted

Die Anzahl der Seiten, die gedruckt wurden. Dieser Wert kann 0 sein, wenn der Druckauftrag keine Seitentrennzeicheninformationen enthält.

Gesendet

Eine SYSTEMTIME-Struktur , die den Zeitpunkt angibt, zu dem dieses Dokument in einem Pool gespeichert wurde.

Dieser Zeitwert ist im UTC-Format (Universal Time Coordinate) angegeben. Sie sollten ihn vor der Anzeige in einen Lokalen Zeitwert konvertieren. Sie können die Konvertierung mithilfe der FileTimeToLocalFileTime-Funktion ausführen.

Bemerkungen

Portmonitore, die TrueEndOfJob nicht unterstützen, legen den Auftrag direkt nach der Übermittlung des Auftrags an den Drucker auf JOB_STATUS_PRINTED fest.

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 (einschließlich Windows.h)
Unicode- und ANSI-Name	_JOB_INFO_1W (Unicode) und _JOB_INFO_1A (ANSI)

Siehe auch

Drucken

Drucken von Spooler-API-Strukturen

EnumJobs

GetJob

SetJob