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.

Comentarios

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, incluso si el administrador del servidor de impresión ha 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	Value
Plataforma de destino	Universal
Encabezado	winppi.h (incluir Winppi.h)
Library	Gdi32.Lib
Archivo DLL	Gdi32.dll