JOB _ INFO _ 2-Struktur

Die JOB _ INFO _ 2-Struktur beschreibt einen vollständigen Satz von Werten, die einem Auftrag zugeordnet sind.

Syntax

typedef struct _JOB_INFO_2 {
  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;
} JOB_INFO_2, *PJOB_INFO_2;

Member

Jobid

Ein Auftragsbezeichnerwert.

pPrinterName

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Namen des Druckers angibt, für den der Auftrag in einen Pool gesetzt wird.

pMachineName

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

pUserName

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

pDocument

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

pNotifyName

Ein Zeiger auf eine auf 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 auf NULL beendete Zeichenfolge, die den Datentyp angibt, der zum Aufzeichnen des Druckauftrags verwendet wird.

pPrintProcessor

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

pParameters

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die Druckprozessorparameter angibt.

pDriverName

Ein Zeiger auf eine auf 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ätein initialisierungs- und Umgebungsdaten für den Druckertreiber enthält.

pStatus

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Status des Druckauftrags angibt. Dieses Member sollte vor Status überprüft werden, und wenn pStatus NULL ist, wird der Status durch den Inhalt des Status-Mitglieds definiert.

pSecurityDescriptor

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

Status

Der Auftragsstatus. Dieser Member kann mindestens einer der folgenden Werte sein.

Wert Bedeutung
AUFTRAGSSTATUS _ _ BLOCKIERT _ DEVQ Der Treiber kann den Auftrag nicht drucken.
AUFTRAGSSTATUS _ _ GELÖSCHT Der Auftrag wurde gelöscht.
AUFTRAGSSTATUS _ _ WIRD GELÖSCHT Der Auftrag wird gelöscht.
_ _ AUFTRAGSSTATUSFEHLER Dem Auftrag ist ein Fehler zugeordnet.
AUFTRAGSSTATUS _ _ OFFLINE Der Drucker ist offline.
AUFTRAGSSTATUS _ _ PAPEROUT Der Drucker ist ohne Papier.
AUFTRAGSSTATUS _ _ ANGEHALTEN Der Auftrag wurde angehalten.
AUFTRAGSSTATUS _ _ GEDRUCKT Der Auftrag wurde gedruckt.
DRUCKEN DES _ _ AUFTRAGSSTATUS Der Auftrag wird gedruckt.
_ _ AUFTRAGSSTATUSNEUSTART Der Auftrag wurde neu gestartet.
_ _ AUFTRAGSSTATUS-SPOOLING Der Auftrag wird spoolt.
_AUFTRAGSSTATUS _ _ BENUTZEREINGRIFF Der Drucker hat einen Fehler, der erfordert, dass der Benutzer etwas macht.

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

Wert Bedeutung
AUFTRAGSSTATUS _ _ ABGESCHLOSSEN Der Auftrag wird an den Drucker gesendet, aber möglicherweise noch nicht gedruckt. Weitere Informationen finden Sie unter Hinweise.
AUFTRAGSSTATUS _ _ BEIBEHALTEN 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 sein (MIN _ PRIORITY bis MAX _ PRIORITY).

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 seiten, die für den Auftrag erforderlich sind. Dieser Wert kann 0 (null) sein, wenn der Druckauftrag keine Informationen zum Seitentrennzeichen enthält.

Größe

Die Größe des Auftrags in Bytes.

Gesendet

Eine SYSTEMTIME-Struktur, die die Zeit angibt, zu der der Auftrag übermittelt wurde.

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

Time

Die Gesamtzeit in Millisekunden, die seit beginn des Drucks des Auftrags verstrichen ist.

PagesPrinted

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

Hinweise

Portmonitore, die TrueEndOfJob nicht unterstützen, legen den Auftrag direkt nach der Übermittlung des Auftrags an den Drucker als _ AUFTRAGSSTATUS _ GEDRUCKT 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 (include Windows.h)
Unicode- und ANSI-Name
_ JOB _ INFO _ 2W (Unicode) und _ JOB INFO _ _ 2A (ANSI)

Siehe auch

Drucken

Drucken von Spooler-API-Strukturen

Devmode

EnumJobs

GetJob

SetJob