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 posibles tipos de página 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. (No se admite actualmente).
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 FALSE y se puede obtener un código de error llamando a GetLastError.

Comentarios

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	Value
Plataforma de destino	Universal
Encabezado	winppi.h (incluir Winppi.h)
Library	Gdi32.Lib
Archivo DLL	Gdi32.dll