ReportJobProcessingProgress-Funktion
Meldet dem Druckspooler-Dienst, ob sich ein XPS-Druckauftrag in der Spooling- oder Renderingphase befindet und welcher Teil der Verarbeitung gerade ausgeführt wird.
Syntax
HRESULT ReportJobProcessingProgress(
_In_ HANDLE printerHandle,
_In_ ULONG jobId,
EPrintXPSJobOperation jobOperation,
EPrintXPSJobProgress jobProgress
);
Parameter
-
printerHandle [in]
-
Ein Druckerhandle, für das die Funktion zum Abrufen von Informationen besteht. Verwenden Sie die OpenPrinter - oder AddPrinter-Funktion , um einen Druckerhandle abzurufen.
-
jobId [in]
-
Gibt den Druckauftrag an, 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 derzeit ausgeführt wird. Dieser Wert bezieht sich auf Ereignisse in der Spooling- oder Renderingphase, abhängig vom Wert von jobOperation.
Rückgabewert
Wenn der Vorgang erfolgreich ist, wird 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ückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.
Hinweis
ReportJobProcessingProgress meldet den Fortschritt des XPS-Druckauftrags nur, wenn sich der Druckauftrag in der Spooling- oder Renderingphase befindet. ReportJobProcessingProgress schlägt fehl, wenn er aufgerufen wird, wenn sich der XPS-Druckauftrag nicht in der Spooling- oder Renderingphase befindet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|