CDC::AbortDoc

Article
06/10/2015

Termine le travail d'impression actuelle et efface tout que l'application a entré à l'appareil depuis le dernier appel à la fonction membre de StartDoc .

int AbortDoc( );

Valeur de retour

Une valeur supérieure ou égale à 0 en cas de réussite, ou une valeur négative si une erreur s'est produite. La liste suivante affiche les valeurs d'erreur courante et leur signification :

Erreur de général deSP_ERROR .
SP_OUTOFDISK pas suffisamment d'espace disque est disponible pour la mise en attente, puis plus d'espace ne devient disponible.
SP_OUTOFMEMORY pas assez de mémoire est disponible pour la mise en attente.
L'utilisateur deSP_USERABORT a effectué le travail via Gestionnaire d'impression.

Notes

Cette fonction membre remplace l'échappement d'imprimante d' ABORTDOC .

AbortDoc doit être utilisé pour effectuer les opérations suivantes :

Opérations d'impression qui ne spécifient pas une fonction d'arrêt à l'aide de SetAbortProc.
Opérations d'impression appel qui n'ont pas encore atteint leur première échappement de NEWFRAME ou de NEXTBAND .

Si une application rencontre une erreur d'impression ou une opération annulée d'impression, elle ne doit pas essayer de terminer l'exécution en utilisant des fonctions membres d' EndDoc ou d' AbortDoc de la classe CDC. GDI complète automatiquement l'exécution avant de retourner la valeur d'erreur.

Si l'application affiche une boîte de dialogue pour permettre à l'utilisateur d'annuler l'opération d'impression, elle doit appeler AbortDoc avant de perdre la boîte de dialogue.

Si Gestionnaire d'impression est utilisé pour démarrer le travail d'impression, l'appel AbortDoc efface le travail entier de spool — l'imprimante n'accepte aucun effet. Si Gestionnaire d'impression n'est pas utilisé pour démarrer le travail d'impression, les données ont peut-être été envoyées à l'imprimante avant qu' AbortDoc a été appelé. Dans ce cas, le pilote d'imprimante aurait réinitialisé l'imprimante (si possible) et si a été fermé le travail d'impression.