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)
Library Gdi32.Lib
DLL Gdi32.dll