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。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | winppi.h (包括 Winppi.h) |
連結庫 | Gdi32.Lib |
DLL | Gdi32.dll |