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。