PartialReplyPrinterChangeNotification 函数 (winsplp.h)
打印后台处理程序的 PartialReplyPrinterChangeNotification 函数允许打印提供程序更新后台处理程序的与通知句柄关联的打印机更改数据库。
语法
BOOL PartialReplyPrinterChangeNotification(
HANDLE hPrinter,
PPRINTER_NOTIFY_INFO_DATA pDataSrc
);
参数
hPrinter
调用方提供的句柄。 此句柄必须以前作为 hNotify 输入接收到打印提供程序的 FindFirstPrinterChangeNotification 函数。
pDataSrc
调用方提供的指向PRINTER_NOTIFY_INFO_DATA结构的指针 (Microsoft Windows SDK文档) 中所述。 可以为 NULL。 有关更多信息,请参见下面的“备注”部分。
返回值
如果操作成功,则函数返回 TRUE。 否则,函数返回 FALSE。 调用方可以通过调用 GetLastError 获取错误代码。
注解
对于指定的通知句柄,后台处理程序的 PartialReplyPrinterChangeNotification 函数将指定PRINTER_NOTIFY_INFO_DATA结构的内容添加到后台处理程序存储PRINTER_NOTIFY_INFO结构内的数组中。 (Windows SDK documentation 中介绍了这些结构。)
调用 PartialReplyPrinterChangeNotification 不会导致后台处理程序通知应用程序已发生更改。 如果打印提供程序的 FindFirstPrinterChangeNotification 函数未设置PRINTER_NOTIFY_STATUS_POLL标志,则提供程序必须调用 ReplyPrinterChangeNotification 才能通知应用程序。
如果 pInfoDataSrc 为 NULL,则会从后台处理程序中删除与指定句柄关联的所有存储信息。 函数通过释放与属于指定句柄的 PRINTER_NOTIFY_INFO_DATA结构的 pBuf 成员关联的所有缓冲区来完成此删除。 然后,该函数在存储PRINTER_NOTIFY_INFO结构中设置PRINTER_NOTIFY_INFO_DISCARDED标志。
有关详细信息,请参阅 支持打印机更改通知。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | winsplp.h (包括 Winsplp.h) |
Library | Spoolss.lib |
DLL | Spoolss.dll |