AppendPrinterNotifyInfoData 函式 (winsplp.h)
列印後台處理程式的 AppendPrinterNotifyInfoData 函式會將指定PRINTER_NOTIFY_INFO_DATA結構的內容新增至指定的PRINTER_NOTIFY_INFO結構。
語法
BOOL AppendPrinterNotifyInfoData(
[in] PPRINTER_NOTIFY_INFO pInfoDest,
PPRINTER_NOTIFY_INFO_DATA pDataSrc,
DWORD fdwFlags
);
參數
[in] pInfoDest
呼叫端提供的 PRINTER_NOTIFY_INFO 結構的指標。
pDataSrc
呼叫端提供的 PRINTER_NOTIFY_INFO_DATA 結構的指標。
fdwFlags
呼叫端提供的旗標。 定義下列旗標。
PRINTER_NOTIFY_INFO_DATA_COMPACT
如果設定,函式會檢查 Type、Field和 Id 所提供 PRINTER_NOTIFY_INFO_DATA 結構的成員。 如果它們全都符合 PRINTER_NOTIFY_INFO_DATA 結構數位的現有元素,則會以提供的 元素覆寫現有的專案。 如果找不到相符專案,函式會將指定的 結構新增至數位結尾。
傳回值
如果工作成功,函式會 TRUE傳回 。 否則,函式會傳回 FALSE 。 呼叫端可以藉由呼叫 getLastError 來取得錯誤碼。
言論
列印提供者的 RefreshPrinterChangeNotification 函式應該呼叫 AppendPrinterNotifyInfoData,在先 呼叫 routerAllocPrinterNotifyInfo 以配置數位及其相關聯PRINTER_NOTIFY_INFO結構的記憶體之後,填入 PRINTER_NOTIFY_INFO_DATA 結構數位。
根據是否已設定PRINTER_NOTIFY_INFO_DATA_COMPACT旗標,函式會將指定的 PRINTER_NOTIFY_INFO_DATA 結構附加至結構數位的結尾,或覆寫現有的數位專案。 如果附加結構,函式會遞增 PRINTER_NOTIFY_INFO 結構的 Count 成員。
如果 AppendPrinterNotifyInfoData 偵測到PRINTER_NOTIFY_INFO_DISCARDED旗標是在指定的 PRINTER_NOTIFY_INFO 結構中設定,則函式會清除所有PRINTER_NOTIFY_INFO_DATA結構,並將錯誤碼設定為ERROR_OUT_OF_STRUCTURES。
如果為 pInfoDataSrc 指定了NULL,AppendPrinterNotifyInfoData 會在指定的 PRINTER_NOTIFY_INFO 結構中設定PRINTER_NOTIFY_INFO_DISCARDED旗標、清除所有 PRINTER_NOTIFY_INFO_DATA 結構,並將錯誤碼設定為ERROR_OUT_OF_STRUCTURES。
(如需PRINTER_NOTIFY_INFO_DISCARDED旗標的詳細資訊,請參閱 Windows SDK 檔中的 FindNextPrinterChangeNotification 描述。
如需詳細資訊,請參閱 支援印表機變更通知。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | winsplp.h (包括 Winsplp.h) |
連結庫 | Spoolss.lib |
DLL | Spoolss.dll |