Fonction PartialReplyPrinterChangeNotification (winsplp.h)

Article
03/01/2024

La fonction PartialReplyPrinterChangeNotification du spouleur d’impression permet à un fournisseur d’impression de mettre à jour la base de données du spouleur des modifications d’imprimante associées à un handle de notification.

Syntaxe

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

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.

pDataSrc

Pointeur fourni par l’appelant vers une structure de PRINTER_NOTIFY_INFO_DATA (décrit dans la documentation Microsoft Windows SDK). Peut être NULL. Pour plus d'informations, consultez la section Notes qui suit.

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

Pour le handle de notification spécifié, la fonction PartialReplyPrinterChangeNotification du spouleur ajoute le contenu de la structure de PRINTER_NOTIFY_INFO_DATA spécifiée au tableau dans la structure stockée PRINTER_NOTIFY_INFO du spouleur. (Ces structures sont décrites dans la documentation SDK Windows.)

L’appel de PartialReplyPrinterChangeNotification n’oblige pas le spouleur à informer l’application que des modifications se sont produites. Si la fonction FindFirstPrinterChangeNotification du fournisseur d’impression n’a pas défini l’indicateur PRINTER_NOTIFY_STATUS_POLL, le fournisseur doit appeler ReplyPrinterChangeNotification pour que l’application soit avertie.

Si pInfoDataSrc a la valeur NULL, toutes les informations stockées associées au handle spécifié sont supprimées du spouleur. La fonction effectue cette suppression en libérant toutes les mémoires tampons associées aux membres pBuf de PRINTER_NOTIFY_INFO_DATA structures appartenant au handle spécifié. La fonction définit ensuite l’indicateur PRINTER_NOTIFY_INFO_DISCARDED dans la structure de PRINTER_NOTIFY_INFO stockée.

Pour plus d’informations, consultez Prise en charge des notifications de modification d’imprimante.