共用方式為


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