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

印刷プロセッサは、 GdiPlayPageEMF を呼び出してページを描画する前に、ページハンドルを取得する必要があります。 Page 値が大きすぎると、関数は ERROR_NO_MORE_ITEMSを返します。

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