GdiGetPageCount 関数 (winppi.h)

GdiGetPageCount 関数は、印刷ジョブ内のページ数を返します。

構文

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

パラメーター

SpoolFileHandle

呼び出し元から提供されたスプール ファイル ハンドル。 GdiGetSpoolFileHandle の以前の呼び出しによって取得されます。

戻り値

操作が成功した場合、関数は現在の印刷ジョブのページ数を返します。 それ以外の場合、関数は 0 を返します。

注釈

GdiGetPageCount 関数は、印刷プロセッサの PrintDocumentOnPrintProcessor 関数内で使用するために、gdi32.dll によってエクスポートされます。

GdiGetPageCount 関数は、印刷サーバー管理者がスプール中に印刷ジョブを印刷する必要があることを指定した場合でも、すべてのページがスプールされるまで戻りません。 したがって、逆順でページを印刷する場合など、ドキュメント処理を開始する前に合計ページ数を取得する必要がない限り、この関数を使用しないでください。

通常、ページ数を決定するための優れた方法は、 GdiGetPageHandle に対して行われた呼び出しの数をカウントすることです。

この一連の関数の詳細については、「 印刷プロセッサでの GDI 関数の使用」を参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	winppi.h (Winppi.h を含む)
Library	Gdi32.Lib
[DLL]	Gdi32.dll