gdiGetPageCount 函数 (winppi.h)

GdiGetPageCount 函数返回打印作业中的页数。

语法

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

SpoolFileHandle

调用方提供的假脱机文件句柄，由先前调用 GdiGetSpoolFileHandle 获取。

如果操作成功，该函数将返回当前打印作业中的页数。否则，函数返回零。

GdiGetPageCount 函数由 gdi32.dll 导出，以便在打印处理器的 PrintDocumentOnPrintProcessor 函数中使用。

GdiGetPageCount 函数在后台打印所有页面之前不会返回，即使打印服务器管理员已指定在后台打印期间应打印作业也是如此。因此，不应使用此函数，除非有必要在开始文档处理之前获取总页计数，例如按相反顺序打印页面。

通常，确定页计数的更好方法是计算对 GdiGetPageHandle 的调用次数。

有关此函数集的其他信息，请参阅在打印处理器中使用 GDI 函数。