Fonction ReplyPrinterChangeNotification (winsplp.h)

Article
02/27/2024

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.