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
如果设置，函数将检查所提供的PRINTER_NOTIFY_INFO_DATA结构的 Type、Field 和 Id 成员。 如果它们都匹配 PRINTER_NOTIFY_INFO_DATA 结构数组的现有元素，则现有元素将被提供的 元素覆盖。 如果未找到匹配项，函数会将指定的结构添加到数组的末尾。

返回值

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

注解

在首先调用 RouterAllocPrinterNotifyInfo 为数组及其关联的PRINTER_NOTIFY_INFO结构分配存储后，打印提供程序的 RefreshPrinterChangeNotification 函数应根据需要经常调用 AppendPrinterNotifyInfoData 以填充PRINTER_NOTIFY_INFO_DATA结构数组。

根据是否设置PRINTER_NOTIFY_INFO_DATA_COMPACT标志，函数会将指定的 PRINTER_NOTIFY_INFO_DATA 结构追加到结构数组的末尾，或者覆盖现有的数组元素。 如果追加结构，函数将递增 PRINTER_NOTIFY_INFO 结构的 Count 成员。

如果 AppendPrinterNotifyInfoData 检测到在指定的PRINTER_NOTIFY_INFO结构中设置了 PRINTER_NOTIFY_INFO_DISCARDED 标志，则函数会清除所有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)
Library Spoolss.lib
DLL Spoolss.dll

另请参阅

RefreshPrinterChangeNotification

RouterAllocPrinterNotifyInfo