GdiGetPageHandle

GdiGetPageHandle function

The GdiGetPageHandle function returns a handle to the specified page within a print job.

Syntax


HANDLE GdiGetPageHandle(
   HANDLE  SpoolFileHandle,
   DWORD   Page,
   LPDWORD pdwPageType
);

Parameters

SpoolFileHandle

Caller-supplied spool file handle, obtained by a previous call to GdiGetSpoolFileHandle.

Page

Caller-supplied page number.

pdwPageType

Caller-supplied pointer to a location that receives the page type. The possible page types are shown in the following table:

Page TypeMeaning

EMF_PP_FORM

The page is a form or has a watermark. (Not currently supported.)

EMF_PP_NORMAL

The page is a normal page.

 

Return value

If the operation succeeds, the function returns TRUE. Otherwise the function returns FALSE, and an error code can be obtained by calling GetLastError.

Remarks

The GdiGetPageHandle function is exported by gdi32.dll for use within a print processor's PrintDocumentOnPrintProcessor function.

Print processors must obtain a page handle before calling GdiPlayPageEMF to draw a page. If a Page value is specified that is too large, the function returns ERROR_NO_MORE_ITEMS.

For additional information, see Using GDI Functions in Print Processors.

Requirements

Target platform

Universal

Header

Winppi.h (include Winppi.h)

Library

Gdi32.Lib

DLL

Gdi32.dll

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft