GdiGetPageCount-Funktion (winppi.h)

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

Syntax

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Parameter

SpoolFileHandle

Vom Aufrufer bereitgestelltes Spooldateihandle, das durch einen vorherigen Aufruf von GdiGetSpoolFileHandle abgerufen wurde.

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.

Hinweise

Die GdiGetPageCount-Funktion wird von gdi32.dll zur Verwendung in der PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors exportiert.

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

Normalerweise besteht eine bessere Methode zum Bestimmen der Seitenanzahl darin, die Anzahl der Aufrufe von GdiGetPageHandle zu zählen.

Weitere Informationen zu diesem Funktionssatz finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.

Anforderungen