GdiGetPageCount 関数 (winppi.h)

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

構文

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

パラメーター

SpoolFileHandle

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

戻り値

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

備考

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

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

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

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

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	winppi.h (Winppi.h を含む)
ライブラリ	Gdi32.Lib
DLL	Gdi32.dll