GdiGetPageCount function

The GdiGetPageCount function returns the number of pages in a print job.

Syntax


DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Parameters

SpoolFileHandle

Caller-supplied spool file handle, obtained by a previous call to GdiGetSpoolFileHandle.

Return value

If the operation succeeds, the function returns the number of pages in the current print job. Otherwise the function returns zero.

Remarks

The GdiGetPageCount function is exported by gdi32.dll for use within a print processor's PrintDocumentOnPrintProcessor function.

Note   The GdiGetPageCount function does not return until all pages have been spooled, even if the print server administrator has specified that print jobs should be printed during spooling. Therefore, this function should not be used unless it is necessary to obtain the total page count before document processing can begin, such as for printing pages in reverse order.

Usually, a better method for determining the page count is to count the number of calls made to GdiGetPageHandle.

For additional information about this set of functions, see Using GDI Functions in Print Processors.

Requirements

Header

Winppi.h (include Winppi.h)

Library

Gdi32.Lib

DLL

Gdi32.dll

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft