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

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

  • Статья

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

Синтаксис

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

Параметры

SpoolFileHandle

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

Page

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

pdwPageType

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

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

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

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

Комментарии

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

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

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

Требования

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