Función GdiGetPageHandle (winppi.h)

La función GdiGetPageHandle devuelve un identificador a la página especificada dentro de un trabajo de impresión.

Sintaxis

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

Parámetros

SpoolFileHandle

Identificador de archivo de cola proporcionado por el autor de la llamada, obtenido por una llamada anterior a GdiGetSpoolFileHandle.

Page

Número de página proporcionado por el autor de la llamada.

pdwPageType

Puntero proporcionado por el autor de la llamada a una ubicación que recibe el tipo de página. Los tipos de página posibles se muestran en la tabla siguiente:

Tipo de página	Significado
EMF_PP_FORM	La página es un formulario o tiene una marca de agua. (Actualmente no se admite).
EMF_PP_NORMAL	La página es una página normal.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve TRUE. De lo contrario, la función devuelve FALSEy se puede obtener un código de error llamando a GetLastError.

Observaciones

La función GdiGetPageHandle se exporta mediante gdi32.dll para su uso en la función PrintDocumentOnPrintProcessor de un procesador de impresión.

Los procesadores de impresión deben obtener un identificador de página antes de llamar a GdiPlayPageEMF para dibujar una página. Si se especifica un valor page demasiado grande, la función devuelve ERROR_NO_MORE_ITEMS.

Para obtener más información, consulte Uso de funciones GDI en procesadores de impresión.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	winppi.h (incluya Winppi.h)
biblioteca de	Gdi32.Lib
DLL de	Gdi32.dll