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 |