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 函式。