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
Winspool.h (include Windows.h)
Bibliothek
Winspool.lib
DLL
Spoolss.dll

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

EPrintXPSJobOperation

EPrintXPSJobProgress