Поделиться через

Функция GdiGetPageCount (winppi.h)

  • Статья

Функция GdiGetPageCount возвращает количество страниц в задании печати.

Синтаксис

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Параметры

SpoolFileHandle

Дескриптор файла очереди вызывающего объекта, полученный при предыдущем вызове GdiGetSpoolFileHandle.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает количество страниц в текущем задании печати. В противном случае функция возвращает ноль.

Комментарии

Функция GdiGetPageCount экспортируется gdi32.dll для использования в функции PrintDocumentOnPrintProcessor процессора печати.

Функция GdiGetPageCount не возвращается до тех пор, пока не будут запущены все страницы, даже если администратор сервера печати указал, что задания печати должны быть напечатаны во время очереди. Поэтому эту функцию не следует использовать, если только не требуется получить общее количество страниц перед началом обработки документа, например для печати страниц в обратном порядке.

Как правило, лучшим способом определения количества страниц является подсчет количества вызовов GdiGetPageHandle.

Дополнительные сведения об этом наборе функций см. в разделе Использование функций GDI в процессорах печати.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть winppi.h (включая Winppi.h)
Библиотека Gdi32.Lib
DLL Gdi32.dll