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

Siehe auch

Drucken

Druckspooler-API-Funktionen

EPrintXPSJobOperation

EPrintXPSJobProgress