Funzione GdiGetPageCount (winppi.h)

La funzione GdiGetPageCount restituisce il numero di pagine in un processo di stampa.

Sintassi

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Parametri

SpoolFileHandle

Handle di file di spooling fornito dal chiamante, ottenuto da una chiamata precedente a GdiGetSpoolFileHandle.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce il numero di pagine nel processo di stampa corrente. In caso contrario, la funzione restituisce zero.

Osservazioni

La funzione GdiGetPageCount viene esportata da gdi32.dll per l'uso all'interno della funzione printDocumentOnPrintProcessor di un processore di stampa.

La funzione GdiGetPageCount non restituisce finché non viene eseguito lo spooling di tutte le pagine, anche se l'amministratore del server di stampa ha specificato che i processi di stampa devono essere stampati durante lo spooling. Pertanto, questa funzione non deve essere utilizzata a meno che non sia necessario ottenere il numero totale di pagine prima che l'elaborazione dei documenti possa iniziare, ad esempio per la stampa di pagine in ordine inverso.

In genere, un metodo migliore per determinare il numero di pagine consiste nel contare il numero di chiamate effettuate a GdiGetPageHandle.

Per altre informazioni su questo set di funzioni, vedere Uso di funzioni GDI in Processori di stampa.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	winppi.h (include Winppi.h)
libreria	Gdi32.Lib
dll	Gdi32.dll