Función GdiGetPageCount (winppi.h)

La función GdiGetPageCount devuelve el número de páginas de un trabajo de impresión.

Sintaxis

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Parámetros

SpoolFileHandle

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

Valor devuelto

Si la operación se realiza correctamente, la función devuelve el número de páginas del trabajo de impresión actual. De lo contrario, la función devuelve cero.

Observaciones

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

La función GdiGetPageCount no devuelve hasta que se hayan colado todas las páginas, aunque el administrador del servidor de impresión haya especificado que los trabajos de impresión se deben imprimir durante la cola. Por lo tanto, esta función no debe usarse a menos que sea necesario obtener el recuento total de páginas antes de que pueda comenzar el procesamiento de documentos, como para imprimir páginas en orden inverso.

Normalmente, un método mejor para determinar el recuento de páginas es contar el número de llamadas realizadas a GdiGetPageHandle.

Para obtener más información sobre este conjunto de funciones, vea 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