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

Функция EndPagePrinter

Функция EndPagePrinter уведомляет о том, что приложение находится в конце страницы в задании печати.

Синтаксис

BOOL EndPagePrinter(
  _In_ HANDLE hPrinter
);

Параметры

hPrinter [in]

Дескриптор принтера, для которого будет завершена страница. Используйте функцию OpenPrinter или AddPrinter для получения дескриптора принтера.

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

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

Если функция завершается ошибкой, возвращаемое значение равно нулю.

Замечания

Замечание

Это блокирующая или синхронная функция, и может не возвращаться немедленно. Насколько быстро эта функция возвращается, зависит от таких факторов времени выполнения, как состояние сети, конфигурация сервера печати и факторы реализации драйвера принтера, которые трудно прогнозировать при написании приложения. Вызов этой функции из потока, который управляет взаимодействием с пользовательским интерфейсом, может привести к тому, что приложение, как представляется, не отвечает.

Последовательность задания печати выглядит следующим образом:

  1. Чтобы начать задание печати, вызовите StartDocPrinter.
  2. Чтобы начать каждую страницу, вызовите StartPagePrinter.
  3. Чтобы записать данные на страницу, вызовите WritePrinter.
  4. Чтобы завершить каждую страницу, вызовите EndPagePrinter.
  5. Повторите 2, 3 и 4 для максимально необходимых страниц.
  6. Чтобы завершить задание печати, вызовите EndDocPrinter.

Если страница в spooled-файле превышает около 350 МБ, она может не печатать и не отправлять сообщение об ошибке. Например, это может произойти при печати больших EMF-файлов. Ограничение размера страницы зависит от многих факторов, включая объем доступной виртуальной памяти, объем памяти, выделенный процессами вызова, и объем фрагментации в куче процесса.

Требования

Требование Ценность
Минимальный поддерживаемый клиент
 Windows 2000 Professional [только классические приложения]
Минимальный поддерживаемый сервер
 Windows 2000 Server [только классические приложения]
Заголовок
Winspool.h (включая Windows.h)
Библиотека
Winspool.lib
Библиотека dll
Spoolss.dll

См. также

Печать

Функции API печати spooler

EndDocPrinter

ОткрытьПринтер

StartDocPrinter

StartPagePrinter

WritePrinter