RouterAllocPrinterNotifyInfo 函数 (winsplp.h)

打印后台处理程序的 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

另请参阅

AppendPrinterNotifyInfoData

RefreshPrinterChangeNotification

RouterFreePrinterNotifyInfo