Fonction de rappel ABORTPROC (wingdi.h)

Article
03/13/2024

La fonction AbortProc est une fonction de rappel définie par l’application utilisée avec la fonction SetAbortProc . Il est appelé lorsqu’un travail d’impression doit être annulé pendant la mise en file d’attente. Le type ABORTPROC définit un pointeur vers cette fonction de rappel. AbortProc est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

ABORTPROC Abortproc;

BOOL Abortproc(
  HDC unnamedParam1,
  int unnamedParam2
)
{...}

Paramètres

unnamedParam1

unnamedParam2

Valeur retournée

La fonction de rappel doit retourner TRUE pour continuer le travail d’impression ou FALSE pour annuler le travail d’impression.

Remarques

Note Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et l’implémentation du pilote d’imprimante, facteurs 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 donner l’impression que l’application ne répond pas.

Si le paramètre iError est SP_OUTOFDISK, l’application n’a pas besoin d’annuler le travail d’impression. S’il n’annule pas le travail, il doit être cédé au Gestionnaire d’impression en appelant la fonction PeekMessage ou GetMessage .

Configuration requise

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]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)