ReportJobProcessingProgress-Funktion
Meldet dem Druckspoolerdienst, ob sich ein XPS-Druckauftrag in der Spooling- oder Renderingphase befindet und welcher Teil der Verarbeitung gerade läuft.
Syntax
HRESULT ReportJobProcessingProgress(
_In_ HANDLE printerHandle,
_In_ ULONG jobId,
EPrintXPSJobOperation jobOperation,
EPrintXPSJobProgress jobProgress
);
Parameter
-
printerHandle [ In]
-
Ein Druckerhandle, für das die Funktion Informationen abrufen soll. Verwenden Sie die OpenPrinter- oder AddPrinter-Funktion, um ein Druckerhandle abzurufen.
-
jobId [ In]
-
Identifiziert den Druckauftrag, für den Daten abgerufen werden sollen. Verwenden Sie die AddJob-Funktion oder die StartDoc-Funktion, um einen Druckauftragsbezeichner abzurufen.
-
jobOperation
-
Gibt an, ob sich der Auftrag in der Spoolingphase oder in der Renderingphase befindet.
-
jobProgress
-
Gibt an, welcher Teil der Verarbeitung gerade durchgeführt wird. Dieser Wert bezieht sich abhängig vom Wert von jobOperation auf Ereignisse in der Spooling- oder Renderingphase.
Rückgabewert
Wenn der Vorgang erfolgreich ist, lautet der Rückgabewert S _ OK, andernfalls enthält das HRESULT einen Fehlercode.
Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung.
Bemerkungen
Hinweis
Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren für Druckertreiber ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion über einen Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, kann dazu bringen, dass die Anwendung scheinbar nicht reagiert.
Hinweis
ReportJobProcessingProgress meldet nur dann den Status des XPS-Druckauftrags, wenn sich der Druckauftrag in der Spooling- oder Renderingphase befindet. ReportJobProcessingProgress schlägt fehl, wenn es aufgerufen wird, wenn sich der XPS-Druckauftrag nicht in der Spooling- oder Renderingphase befindet.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|