AbortPrinter fonction)

La fonction AbortPrinter supprime le fichier de mise en file d’attente de l’imprimante si celle-ci est configurée pour la mise en file d’attente.

Syntaxe

BOOL AbortPrinter(
  _In_ HANDLE hPrinter
);

Paramètres

hPrinter [ dans]

Handle vers l’imprimante à partir de laquelle le fichier de mise en file d’attente est supprimé. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.

Valeur de retour

Si la fonction est réussie, la valeur de retour est une valeur différente de zéro.

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

Notes

Notes

Il s’agit d’une fonction de blocage ou synchrone qui peut ne pas être renvoyée immédiatement. La vitesse à laquelle cette fonction est retournée dépend des facteurs d’exécution tels que l’état du réseau, la configuration du serveur d’impression et les facteurs d’implémentation des pilotes d’imprimante qui sont 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 faire que l’application semble ne pas répondre.

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 se présente comme suit :

  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 les étapes 2, 3 et 4 pour autant de pages que nécessaire.
  6. Pour mettre fin au travail d’impression, appelez EndDocPrinter.

Quand une page dans un fichier mis en file d’attente dépasse environ 350 Mo, elle peut échouer 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 de la quantité de mémoire virtuelle disponible, de la quantité de mémoire allouée par les processus d’appel et de la quantité de fragmentation dans le segment de mémoire 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