GdiGetPageCount 函式（winppi.h）

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

語法

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

SpoolFileHandle

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

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

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

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

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

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