CDC::AbortDoc

Articolo
06/10/2015

Termina il processo di stampa corrente e cancella tutto che l'applicazione ha scritto nel dispositivo dall'ultima chiamata alla funzione membro StartDoc.

int AbortDoc( );

Valore restituito

Un valore maggiore o uguale a 0 se l'operazione riesce, o un valore negativo se si è verificato un errore. Di seguito sono elencati i valori di errore comune e i relativi significati:

Errore generale diSP_ERROR.
SP_OUTOFDISK insufficiente spazio su disco è attualmente disponibile per aggiungere e non risulterà più spazio disponibile.
SP_OUTOFMEMORY memoria insufficiente è disponibile per aggiungere.
L'utente diSP_USERABORT ha terminato il processo tramite il Print Manager.

Note

Questa funzione membro sostituisce la fuga della stampante ABORTDOC.

AbortDoc deve essere utilizzato per terminare il seguente:

Operazioni di stampa non specificare una funzione di interruzione utilizzando SetAbortProc.
Operazioni di stampa che non hanno raggiunto chiamata della prima esecuzione NEXTBAND o NEWFRAME.

Se un'applicazione viene rilevato un errore di stampa o di stampa annullato, non deve tentare di terminare l'operazione utilizzando le funzioni membro AbortDoc o EndDoc di classe CDC. GDI automaticamente termina l'operazione prima di restituire il valore di errore.

Se l'applicazione viene visualizzata una finestra di dialogo per consentire all'utente di annullare l'operazione di stampa, deve chiamare AbortDoc prima di eliminare la finestra di dialogo.

Se il Print Manager è stato utilizzato per avviare il processo di stampa, chiamare AbortDoc elimina l'intero processo di spooling della stampante non viene ricevuto alcuna operazione. Se il Print Manager non è stato utilizzato per avviare il processo di stampa, i dati possono essere inviati alla stampante prima AbortDoc sia stato chiamato. In questo caso, il driver della stampante avrebbe reimpostato la stampante (quando possibile e si è chiuso il processo di stampa.