Funzione EndPagePrinter
La funzione EndPagePrinter informa lo spooler di stampa che l'applicazione si trova alla fine di una pagina in un processo di stampa.
Sintassi
BOOL EndPagePrinter(
_In_ HANDLE hPrinter
);
Parametri
-
hPrinter [in]
-
Gestire la stampante per la quale verrà completata la pagina. Usare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Nota
Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.
La sequenza per un processo di stampa è la seguente:
- Per iniziare un processo di stampa, chiamare StartDocPrinter.
- Per iniziare ogni pagina, chiamare StartPagePrinter.
- Per scrivere dati in una pagina, chiamare WritePrinter.
- Per terminare ogni pagina, chiamare EndPagePrinter.
- Ripetere 2, 3 e 4 per tutte le pagine necessarie.
- Per terminare il processo di stampa, chiamare EndDocPrinter.
Quando una pagina in un file spooling supera circa 350 MB, può non riuscire a stampare e non inviare un messaggio di errore. Ad esempio, questo può verificarsi quando si stampano file EMF di grandi dimensioni. Il limite delle dimensioni della pagina dipende da molti fattori, tra cui la quantità di memoria virtuale disponibile, la quantità di memoria allocata dai processi chiamanti e la quantità di frammentazione nell'heap del processo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|