AbortPrinter, fonction

La fonction AbortPrinter supprime le fichier depool d’une imprimante si l’imprimante est configurée pour lepooling.

Syntaxe

BOOL AbortPrinter(
  _In_ HANDLE hPrinter
);

Paramètres

hPrinter [in]

Gérez l’imprimante à partir de laquelle le fichier depool est supprimé. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur non nulle.

Si la fonction échoue, la valeur de retour est égale à zéro.

Notes

Notes

Il s’agit d’une fonction bloquante ou synchrone et peut ne pas retourner immédiatement. La rapidité de cette fonction dépend de facteurs d’exécution tels que l’état réseau, la configuration du serveur d’impression et les facteurs d’implémentation du pilote d’imprimante difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut rendre l’application non réponse.

Si l’imprimante n’est pas configurée pour lepooling, la fonction AbortPrinter n’a aucun effet.

La séquence d’une tâche d’impression est la suivante :

  1. Pour commencer un travail d’impression, appelez StartDocPrinter.
  2. Pour commencer chaque page, appelez StartPagePrinter.
  3. Pour écrire des données dans une page, appelez WritePrinter.
  4. Pour terminer chaque page, appelez EndPagePrinter.
  5. Répétez 2, 3 et 4 pour autant de pages que nécessaire.
  6. Pour terminer le travail d’impression, appelez EndDocPrinter.

Lorsqu’une page d’un fichier en pool dépasse environ 350 Mo, elle peut ne pas imprimer et ne pas envoyer de message d’erreur. Par exemple, cela peut se produire lors de l’impression de fichiers EMF volumineux. La limite de taille de page dépend de nombreux facteurs, notamment la quantité de mémoire virtuelle disponible, la quantité de mémoire allouée par les processus appelant et la quantité de fragmentation dans le tas de processus.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Winspool.h (inclure Windows.h)
Bibliothèque
Winspool.lib
DLL
Spoolss.dll

Voir aussi

Impression

Fonctions API du spouleur d’impression

EndDocPrinter

EndPagePrinter

OpenPrinter

StartDocPrinter

StartPagePrinter

WritePrinter