XPS_JOB_STATUS-Struktur (xpsprint.h)

[XPS_JOB_STATUS wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. ]

Enthält eine Momentaufnahme der auftrags-status.

Syntax

typedef struct __MIDL___MIDL_itf_xpsprint_0000_0000_0002 {
  UINT32             jobId;
  INT32              currentDocument;
  INT32              currentPage;
  INT32              currentPageTotal;
  XPS_JOB_COMPLETION completion;
  HRESULT            jobStatus;
} XPS_JOB_STATUS;

Member

jobId

Die Spoolerauftrags-ID, die dem Druckauftrag zugewiesen ist. Wenn noch keine Auftrags-ID zugewiesen wurde, ist jobId 0.

currentDocument

Der nullbasierte Index des zuletzt verarbeiteten Dokuments im Druckauftrag; 0 ist das erste Dokument, 1 das nächste und so weiter. Wenn keine Dokumente verarbeitet wurden, weist currentDocument den Wert -1 auf.

currentPage

Der nullbasierte Index der zuletzt verarbeiteten Seite im aktuellen Dokument; 0 ist die erste Seite, 1 die nächste usw. Wenn keine Seiten verarbeitet wurden, weist currentPage den Wert -1 auf.

currentPageTotal

Eine laufende Summe der Anzahl der Seiten, die vom Druckauftrag verarbeitet wurden. Am Anfang des Auftrags ist dieser Wert 0. Da jede Seite in jedem Dokument vom Auftrag verarbeitet wird, erhöht sich dieser Wert monoton.

completion

Der XPS_JOB_COMPLETION Wert, der den Abschluss status des Auftrags angibt. Dieser Wert ändert sich, wenn das im completionEvent-Parameter von StartXpsPrintJob übergebene Ereignis am Ende eines Auftrags signalisiert wird. Wenn der Druckauftrag fehlschlägt, wird dieser Wert XPS_JOB_FAILED, wobei jobStatus den Fehlercode des Fehlers enthält.

jobStatus

Der Fehlerstatus des Auftrags. Wenn der Auftrag ohne Fehler abgeschlossen wird, wird dieser Wert S_OK. Wenn ein Fehler dazu führt, dass der Druckauftrag beendet wird, ist dieser Wert der Fehlercode des Fehlers.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	xpsprint.h

Siehe auch

Dokumente

IXpsPrintJob::GetJobStatus

XML Paper Specification

XPS_JOB_COMPLETION