RouterFreePrinterNotifyInfo 函数 (winsplp.h)

  • 项目

打印后台处理程序的 RouterFreePrinterNotifyInfo 函数解除分配指定的PRINTER_NOTIFY_INFO结构及其关联的PRINTER_NOTIFY_INFO_DATA结构数组。 (Microsoft Windows SDK 文档中介绍了这些结构。)

语法

BOOL RouterFreePrinterNotifyInfo(
  [in, optional] PPRINTER_NOTIFY_INFO pInfo
);

参数

[in, optional] pInfo

调用方提供的指向PRINTER_NOTIFY_INFO结构的指针 (Windows SDK文档) 中所述。

返回值

如果操作成功，则函数返回 TRUE。 否则，函数返回 FALSE。

注解

打印提供程序的 RefreshPrinterChangeNotification 函数应调用 RouterFreePrinterNotifyInfo 解除分配以前由 RouterAllocPrinterNotifyInfo 分配的结构，但前提是 RefreshPrinterChangeNotification 遇到错误。 如果 RefreshPrinterChangeNotification 成功，则应假定客户端应用程序将解除分配结构。

除了解除分配指定的PRINTER_NOTIFY_INFO结构及其关联的PRINTER_NOTIFY_INFO_DATA结构数组外，函数还会解除分配 pBuf 在PRINTER_NOTIFY_INFO_DATA结构数组的任何元素中指向的缓冲区空间。

有关详细信息，请参阅 支持打印机更改通知。

要求

要求 值
目标平台 桌面
标头 winsplp.h (包括 Winsplp.h)
Library Spoolss.lib
DLL Spoolss.dll

另请参阅

RefreshPrinterChangeNotification

RouterAllocPrinterNotifyInfo