GdiGetPageCount-Funktion (winppi.h)

Die Funktion GdiGetPageCount gibt die Anzahl der Seiten in einem Druckauftrag zurück.

Syntax

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Parameter

SpoolFileHandle

Vom Aufrufer bereitgestellter Spooldateihandle, abgerufen durch einen vorherigen Aufruf von GdiGetSpoolFileHandle.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion die Anzahl der Seiten im aktuellen Druckauftrag zurück. Andernfalls gibt die Funktion null zurück.

Bemerkungen

Die GdiGetPageCount-Funktion wird von gdi32.dll für die Verwendung innerhalb der PrintDocumentOnPrintProcessor--Funktion eines Druckprozessors exportiert.

Die GdiGetPageCount-Funktion wird erst zurückgegeben, wenn alle Seiten gepoolt wurden, auch wenn der Druckserveradministrator angegeben hat, dass Druckaufträge während des Spoolings gedruckt werden sollen. Daher sollte diese Funktion nicht verwendet werden, es sei denn, es ist erforderlich, die Gesamtanzahl der Seiten abzurufen, bevor die Dokumentverarbeitung beginnen kann, z. B. für das Drucken von Seiten in umgekehrter Reihenfolge.

In der Regel besteht eine bessere Methode zum Ermitteln der Seitenanzahl darin, die Anzahl der Aufrufe zu zählen, die an GdiGetPageHandlegetätigt wurden.

Weitere Informationen zu dieser Reihe von Funktionen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	winppi.h (include Winppi.h)
Library	Gdi32.Lib
DLL-	Gdi32.dll