GdiGetPageCount 函式 (winppi.h)

GdiGetPageCount 函式會傳回列印作業中的頁數。

語法

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

SpoolFileHandle

呼叫端提供的多任務緩衝處理檔句柄，由先前呼叫 GdiGetSpoolFileHandle 取得。

如果作業成功，函式會傳回目前列印作業中的頁數。否則函式會傳回零。

GdiGetPageCount 函式是由 gdi32.dll 匯出，用於列印處理器的 PrintDocumentOnPrintProcessor 函式內。

GdiGetPageCount 函式不會傳回，直到所有頁面都經過多任務緩衝處理之後，即使列印伺服器管理員已指定列印作業應該在多任務緩衝處理期間列印也一樣。因此，除非必須取得文件處理開始前的總頁數，例如以反向順序列印頁面，否則不應使用此函式。

通常，判斷頁面計數的較佳方法是計算對 GdiGetPageHandle 的呼叫數目。

如需這組函式的其他資訊，請參閱在列印處理器中使用 GDI 函式。