Fonction RouterAllocPrinterNotifyInfo (winsplp.h)
La fonction du RouterAllocPrinterNotifyInfo spouleur d’impression alloue une structure PRINTER_NOTIFY_INFO et un tableau de structures PRINTER_NOTIFY_INFO_DATA. (Ces structures sont décrites dans la documentation Microsoft Windows SDK.)
Syntaxe
PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
DWORD cPrinterNotifyInfoData
);
Paramètres
cPrinterNotifyInfoData
Numéro fourni par l’appelant spécifiant la taille du tableau de structure PRINTER_NOTIFY_INFO_DATA à allouer.
Valeur retournée
La fonction retourne un pointeur vers la structure PRINTER_NOTIFY_INFO allouée.
Remarques
Les fournisseurs d’impression doivent appeler RouterAllocPrinterNotifyInfo pour allouer la structure PRINTER_NOTIFY_INFO et le tableau de structure PRINTER_NOTIFY_INFO_DATA que la fonction RefreshPrinterChangeNotification du fournisseur doit fournir.
La RouterAllocPrinterNotifyInfo fonction initialise le membre Version de la structure PRINTER_NOTIFY_INFO sur la version actuelle de l’implémentation de notification du spouleur. Il initialise les membres Flag etCount de la structure sur zéro, quel que soit le nombre spécifié pour cPrinterNotifyInfoData.
Les fournisseurs d’impression doivent appeler AppendPrinterNotifyInfoData pour renseigner les membres du tableau de structure PRINTER_NOTIFY_INFO_DATA.
Si RefreshPrinterChangeNotification s’exécute correctement et retourne les structures allouées à l’appelant, vous devez supposer que l’appelant libère la mémoire de structure. Toutefois, si RefreshPrinterChangeNotification rencontre une erreur, il doit appeler RouterFreePrinterNotifyInfo pour libérer la mémoire.
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 |