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。