Функция RouterAllocPrinterNotifyInfo (winsplp.h)

Функция очереди RouterAllocPrinterNotifyInfo печати печати выделяет структуру PRINTER_NOTIFY_INFO и массив PRINTER_NOTIFY_INFO_DATA структур. (Эти структуры описаны в документации по Microsoft Windows SDK.)

Синтаксис

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

Параметры

cPrinterNotifyInfoData

Номер, предоставленный вызывающим объектом, указывающий размер выделенного массива структуры PRINTER_NOTIFY_INFO_DATA.

Возвращаемое значение

Функция возвращает указатель на выделенную PRINTER_NOTIFY_INFO структуру.

Комментарии

Поставщики печати должны вызывать метод RouterAllocPrinterNotifyInfo для выделения структуры PRINTER_NOTIFY_INFO и массива структуры PRINTER_NOTIFY_INFO_DATA, который должна предоставить функция RefreshPrinterChangeNotification поставщика.

Функция RouterAllocPrinterNotifyInfo инициализирует член version структуры PRINTER_NOTIFY_INFO текущей версией реализации уведомлений очереди очереди. Он инициализирует элементы Flags и Count структуры равными нулю, независимо от числа, указанного для cPrinterNotifyInfoData.

Поставщики печати должны вызывать AppendPrinterNotifyInfoData для заполнения элементов массива структуры PRINTER_NOTIFY_INFO_DATA.

Если RefreshPrinterChangeNotification выполняется успешно и возвращает выделенные структуры вызывающей объекту, следует предположить, что вызывающий объект отменит выделение памяти структуры. Однако если RefreshPrinterChangeNotification возникает ошибка, следует вызвать RouterFreePrinterNotifyInfo , чтобы освободить память.

Дополнительные сведения см. в разделе Поддержка уведомлений об изменении принтера.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	winsplp.h (включая Winsplp.h)
Библиотека	Spoolss.lib
DLL	Spoolss.dll

См. также раздел

AppendPrinterNotifyInfoData

RefreshPrinterChangeNotification

RouterFreePrinterNotifyInfo