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 spool 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.

Commenti

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 fino a quando non viene eseguito ilpooling 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 usata 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 conteggio delle pagine consiste nel contare il numero di chiamate effettuate a GdiGetPageHandle.

Per altre informazioni su questo set di funzioni, vedere Uso di funzioni GDI nei processori di stampa.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	winppi.h (include Winppi.h)
Libreria	Gdi32.Lib
DLL	Gdi32.dll