AbortPrinter (funzione)

La funzione AbortPrinter Elimina il file di spool della stampante se la stampante è configurata per lo spooling.

Sintassi

BOOL AbortPrinter(
  _In_ HANDLE hPrinter
);

Parametri

hPrinter [ in]

Handle per la stampante da cui viene eliminato il file di spooling. Utilizzare la funzione OpenPrinter o AddPrinter per recuperare un handle di 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 essere restituita immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime quali 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 di questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe far sembrare che l'applicazione non risponda.

Se la stampante non è configurata per lo spooling, la funzione AbortPrinter non ha alcun effetto.

La sequenza per un processo di stampa è la seguente:

  1. Per iniziare un processo di stampa, chiamare StartDocPrinter.
  2. Per iniziare ogni pagina, chiamare StartPagePrinter.
  3. Per scrivere i dati in una pagina, chiamare WritePrinter.
  4. Per terminare ogni pagina, chiamare EndPagePrinter.
  5. Ripetere 2, 3 e 4 per il numero di pagine necessario.
  6. Per terminare il processo di stampa, chiamare EndDocPrinter.

Quando una pagina in un file con spooling supera circa 350 MB, potrebbe non essere possibile stampare e inviare un messaggio di errore. Questo può verificarsi, ad esempio, durante la stampa di 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 chiamante e la quantità di frammentazione nell'heap dei processi.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Winspool. h (include Windows. h)
Libreria
Winspool. lib
DLL
Spoolss.dll

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

EndDocPrinter

EndPagePrinter

OpenPrinter

StartDocPrinter

StartPagePrinter

WritePrinter