PartialReplyPrinterChangeNotification 函数 (winsplp.h)

打印后台处理程序的 PartialReplyPrinterChangeNotification 函数允许打印提供程序更新与通知句柄关联的打印机更改的后台处理程序数据库。

语法

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

参数

hPrinter

调用方提供的句柄。 此句柄以前必须作为打印提供程序 的 findFirstPrinterChangeNotification 函数的 hNotify 输入接收。

pDataSrc

调用方提供的指向PRINTER_NOTIFY_INFO_DATA结构的指针(Microsoft Windows SDK 文档中所述)。 可以为 NULL 。 有关详细信息,请参阅以下“备注”部分。

返回值

如果作成功,该函数将返回 true 。 否则,该函数返回 FALSE。 调用方可以通过调用 GetLastError来获取错误代码。

言论

对于指定的通知句柄,后台处理程序的 PartialReplyPrinterChangeNotification 函数将指定PRINTER_NOTIFY_INFO_DATA结构的内容添加到后台处理程序的存储PRINTER_NOTIFY_INFO结构中的数组中。 (这些结构在 Windows SDK 文档中介绍)。

调用 PartialReplyPrinterChangeNotification 不会导致后台处理程序通知应用程序发生了更改。 如果打印提供程序的 FindFirstPrinterChangeNotification 函数未设置PRINTER_NOTIFY_STATUS_POLL标志,则提供程序必须调用 ReplyPrinterChangeNotification,才能通知应用程序。

如果 pInfoDataSrcNULL,则会从后台处理程序中删除与指定句柄关联的所有存储信息。 该函数通过释放与属于指定句柄PRINTER_NOTIFY_INFO_DATA结构 pBuf 关联的所有缓冲区 成员来实现此删除。 然后,该函数在存储PRINTER_NOTIFY_INFO结构中设置PRINTER_NOTIFY_INFO_DISCARDED标志。

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

要求

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

另请参阅

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification