AbortPrinter |
winspool.drv | Annule l'imprimante |
---|---|---|
Windows 9X, NT 3.1+, 2000, XP, 2003 |
Syntaxe
BOOL AbortPrinter(HANDLE hPrinter); |
Paramètres
Nom | Description |
---|---|
hPrinter | Ce paramètre permet d'indiquer le Handle d'objet de l'imprimante. |
Description
Cette fonction permet d'effacer un fichier dans le tampon d'impression si l'imprimante est configurée avec un tampon d'impression.
Remarques
- Cette fonction est bloquante ou synchrone et pourrait ne pas revenir immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d'exécution tels que l'état du réseau, la configuration du serveur d'impression et les facteurs de mise en oeuvre du pilote d'imprimante difficiles à prévoir lors de l'écriture d'une application. L'appel de cette fonction à partir d'un processus léger gérant les interactions avec l'interface utilisateur peut donner l'impression que l'application ne répond pas.
- Si l'imprimante n'est pas configurée pour la mise en file d'attente, la fonction AbortPrinter n'a aucun effet.
- La séquence d'un travail d'impression est la suivante : Pour commencer un travail d'impression, appelez StartDocPrinter. Pour commencer chaque page, appelez StartPagePrinter. Pour écrire des données sur une page, appelez WritePrinter. Pour terminer chaque page, appelez EndPagePrinter. Répétez les étapes 2, 3 et 4 pour autant de pages que nécessaire. Pour terminer le travail d'impression, appelez EndDocPrinter.
- Lorsqu'une page d'un fichier de tampon d'impression dépasse environ 350 Mo, son impression peut échouer et ne pas envoyer de message d'erreur. Par exemple, cette situation peut se produire lors de l'impression de gros fichiers EMF. La taille maximale de la page dépend de nombreux facteurs, notamment la quantité de mémoire virtuelle disponible, la quantité de mémoire allouée par les processus appelants et la quantité de fragmentation dans le tas de processus.
Voir également
Langage de programmation - C pour Windows - OpenPrinterA
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Mercredi, le 6 août 2014