JOB_INFO_4 Struktur

Artikel
06/13/2023

Beschreibt einen vollständigen Satz von Werten, die einem Auftrag zugeordnet sind, und unterstützt große Spooldateien mit Größen, die mit 64 Bit ausgedrückt werden.

Syntax

typedef struct _JOB_INFO_4 {
  DWORD                JobId;
  LPTSTR               pPrinterName;
  LPTSTR               pMachineName;
  LPTSTR               pUserName;
  LPTSTR               pDocument;
  LPTSTR               pNotifyName;
  LPTSTR               pDatatype;
  LPTSTR               pPrintProcessor;
  LPTSTR               pParameters;
  LPTSTR               pDriverName;
  LPDEVMODE            pDevMode;
  LPTSTR               pStatus;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Status;
  DWORD                Priority;
  DWORD                Position;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                TotalPages;
  DWORD                Size;
  SYSTEMTIME           Submitted;
  DWORD                Time;
  DWORD                PagesPrinted;
  LONG                 SizeHigh;
} JOB_INFO_4, *PJOB_INFO_4;

Member

Jobid

Ein Auftragsbezeichnerwert.

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-beendete 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").

pNotifyName

Ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Benutzers angibt, der benachrichtigt werden soll, wenn der Auftrag gedruckt wurde oder wenn beim Drucken des Auftrags ein Fehler auftritt.

pDatatype

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

pPrintProcessor

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Druckprozessors angibt, der zum Drucken des Auftrags verwendet werden soll.

pParameters

Ein Zeiger auf eine null-beendete Zeichenfolge, die Druckprozessorparameter angibt.

pDriverName

Ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Druckertreibers angibt, der zum Verarbeiten des Druckauftrags verwendet werden soll.

pDevMode

Ein Zeiger auf eine DEVMODE-Struktur , die Geräteinitialisierungs- und Umgebungsdaten für den Druckertreiber enthält.

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.

pSecurityDescriptor

Der Wert dieses Members ist NULL. Das Abrufen und Festlegen von Dokumentsicherheitsdeskriptoren wird in dieser Version nicht unterstützt.

Status

Der Auftrag status. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln:

Wert	Bedeutung
JOB_STATUS_BLOCKED_DEVQ	Der Treiber kann den Auftrag nicht drucken.
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_SPOOLING	Auftrag ist Spooling.
JOB_STATUS_USER_INTERVENTION	Der Drucker weist einen Fehler auf, der erfordert, dass der Benutzer etwas tun muss.

In Windows XP und höheren Versionen von Windows können auch die folgenden Werte verwendet werden:

Wert	Bedeutung
JOB_STATUS_COMPLETE	Der Auftrag wird an den Drucker gesendet, aber möglicherweise noch nicht gedruckt. Weitere Informationen finden Sie unter Hinweise.
JOB_STATUS_RETAINED	Der Auftrag wurde nach dem Drucken in der Druckwarteschlange beibehalten.

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.

StartTime

Der früheste Zeitpunkt, zu dem der Auftrag gedruckt werden kann.

UntilTime

Der letzte Zeitpunkt, zu dem der Auftrag gedruckt werden kann.

TotalPages

Die Anzahl der für den Auftrag erforderlichen Seiten. Dieser Wert kann 0 sein, wenn der Druckauftrag keine Seitentrennzeicheninformationen enthält.

Größe

Die unteren vier Bytes der Größe des Auftrags in Bytes. Siehe auch das SizeHigh-Element unten.

Gesendet

Eine SYSTEMTIME-Struktur , die den Zeitpunkt angibt, zu dem der Auftrag übermittelt 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.

Time

Die Gesamtzeit in Millisekunden, die seit Beginn des Druckvorgangs verstrichen ist.

PagesPrinted

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

SizeHigh

Die höheren vier Bytes der Größe des Auftrags in Bytes. Siehe auch das Element Größe oben.

Bemerkungen

Portmonitore, die TrueEndOfJob nicht unterstützen, legen den Auftrag sofort 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
Unicode- und ANSI-Name	_JOB_INFO_4W (Unicode) und _JOB_INFO_4A (ANSI)

Siehe auch

Drucken
Drucken von Spooler-API-Strukturen
DEVMODE
EnumJobs
GetJob
SetJob

Freigeben über