打印后台处理程序的 RouterAllocPrinterNotifyInfo 函数分配PRINTER_NOTIFY_INFO结构和PRINTER_NOTIFY_INFO_DATA结构的数组。 (Microsoft Windows SDK 文档介绍了这些结构。
语法
PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
DWORD cPrinterNotifyInfoData
);
参数
cPrinterNotifyInfoData
调用方提供的号码,指定要分配的PRINTER_NOTIFY_INFO_DATA结构数组的大小。
返回值
该函数返回指向已分配PRINTER_NOTIFY_INFO结构的指针。
言论
打印提供程序应调用 RouterAllocPrinterNotifyInfo 来分配PRINTER_NOTIFY_INFO结构和提供程序 RefreshPrinterChangeNotification 函数必须提供的PRINTER_NOTIFY_INFO_DATA结构数组。
RouterAllocPrinterNotifyInfo 函数将PRINTER_NOTIFY_INFO结构的 版本 成员初始化为后台处理程序通知实现的当前版本。 它初始化结构的 标志,并将计数 成员数初始化为零,而不考虑为 cPrinterNotifyInfoData指定的数字。
打印提供程序应调用 AppendPrinterNotifyInfoData 以填充PRINTER_NOTIFY_INFO_DATA结构数组的成员。
如果 RefreshPrinterChangeNotification 成功执行并将分配的结构返回到调用方,则应假定调用方将解除分配结构内存。 但是,如果 RefreshPrinterChangeNotification 遇到错误,则应调用 RouterFreePrinterNotifyInfo 解除分配内存。
有关详细信息,请参阅 支持打印机更改通知。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | winsplp.h (包括 Winsplp.h) |
| 库 | Spoolss.lib |
| DLL | Spoolss.dll |