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 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) |
程式庫 | Spoolss.lib |
Dll | Spoolss.dll |