Fonction ReplyPrinterChangeNotification (winsplp.h)
La fonction ReplyPrinterChangeNotification du spouleur d’impression permet à un fournisseur d’impression de mettre à jour la base de données du spouleur des événements de file d’attente d’impression associés à un handle de notification et d’informer le client que des événements de file d’attente d’impression se sont produits.
Syntaxe
BOOL ReplyPrinterChangeNotification(
HANDLE hPrinter,
DWORD fdwChangeFlags,
[out, optional] PDWORD pdwResult,
[in, optional] PVOID pPrinterNotifyInfo
);
Paramètres
hPrinter
Handle fourni par l’appelant. Ce handle doit avoir été reçu précédemment en tant qu’entrée hNotify pour la fonction FindFirstPrinterChangeNotification du fournisseur d’impression.
fdwChangeFlags
Un ou plusieurs indicateurs PRINTER_CHANGE_ préfixés fournis par l’appelant, répertoriés dans la description de la documentation Microsoft Windows SDK de FindNextPrinterChangeNotification.
[out, optional] pdwResult
facultatif. S’il n’est pas NULL, il reçoit des indicateurs fournis par un spouleur PRINTER_NOTIFY_INFO préfixés indiquant les résultats de la mise à jour des informations fournies.
[in, optional] pPrinterNotifyInfo
facultatif. Adresse fournie par l’appelant d’une structure PRINTER_NOTIFY_INFO (décrite dans la documentation SDK Windows). Peut avoir la valeur NULL si aucune nouvelle information de notification n’est ajoutée.
Valeur retournée
Si l’opération réussit, la fonction retourne TRUE. Sinon, la fonction retourne FALSE. L’appelant peut obtenir un code d’erreur en appelant GetLastError.
Remarques
Les fournisseurs d’impression qui ne prennent pas en charge l’interrogation (voir FindFirstPrinterChangeNotification) doivent informer le spouleur de l’occurrence de tous les événements représentés par les indicateurs préfixés PRINTER_CHANGE_ reçus par la fonction FindFirstPrinterChangeNotification du fournisseur. Lorsqu’un événement se produit, le fournisseur d’impression peut appeler ReplyPrinterChangeNotification pour informer le spouleur de l’événement et fournir des informations associées à l’événement. Le spouleur effectue le suivi de ces informations d’événement, pour chaque handle de notification, et remet les informations à une application lorsque l’application appelle FindNextPrinterChangeNotification (décrit dans la documentation SDK Windows).
Lorsqu’un fournisseur d’impression appelle ReplyPrinterChangeNotification, il doit identifier l’événement qui s’est produit en définissant un indicateur préfixé PRINTER_CHANGE_ dans fwdFlags ou en utilisant pPrinterNotifyInfo pour renvoyer une structure de PRINTER_NOTIFY_INFO. (Utilisez les indicateurs répertoriés dans la documentation du SDK Windows la description de FindNextPrinterChangeNotification, et non les indicateurs répertoriés dans la description de FindFirstPrinterChangeNotification de la documentation du SDK Windows.)
En appelant ReplyPrinterChangeNotification , le spouleur signale à l’application cliente qu’un événement de file d’attente d’impression s’est produit. Cela se produit même si le fournisseur fournit NULL pour pPrinterNotifyInfo. Pour mettre à jour l’enregistrement du spouleur des modifications de file d’attente d’impression sans avertir le client, utilisez PartialReplyPrinterChangeNotification. Il est courant d’appeler PartialReplyPrinterChangeNotification plusieurs fois pour mettre à jour la base de données du spouleur, puis d’appeler ReplyPrinterChangeNotification pour informer le client que des modifications se sont produites.
Pour plus d’informations, consultez Prise en charge des notifications de modification d’imprimante.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | winsplp.h (inclure Winsplp.h) |
Bibliothèque | Spoolss.lib |
DLL | Spoolss.dll |