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

Статья
02/07/2025

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

Синтаксис

HANDLE GdiGetPageHandle(
  HANDLE  SpoolFileHandle,
  DWORD   Page,
  LPDWORD pdwPageType
);

Параметры

SpoolFileHandle

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

Page

Номер страницы, предоставленный вызывающим абонентом.

pdwPageType

Указатель, предоставленный вызывающим абонентом, на расположение, которое получает тип страницы. Возможные типы страниц показаны в следующей таблице:

Тип страницы	Значение
EMF_PP_FORM	Страница представляет собой форму или подложку. (В настоящее время не поддерживается.)
EMF_PP_NORMAL	Страница является обычной страницей.

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

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

Замечания

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

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

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	winppi.h (include Winppi.h)
библиотеки	Gdi32.Lib
DLL	Gdi32.dll

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