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

Функция очереди RouterFreePrinterNotifyInfo печати освобождает указанную структуру PRINTER_NOTIFY_INFO и связанные с ней PRINTER_NOTIFY_INFO_DATA массиве структуры. (Эти структуры описаны в документации по Microsoft Windows SDK.)

Синтаксис

BOOL RouterFreePrinterNotifyInfo(
  [in, optional] PPRINTER_NOTIFY_INFO pInfo
);

Параметры

[in, optional] pInfo

Предоставленный вызывающим элементом указатель на структуру PRINTER_NOTIFY_INFO (описано в документации по Windows SDK).

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

Если операция выполнена успешно, функция возвращает значение TRUE. В противном случае функция возвращает значение FALSE.

Комментарии

Функция RefreshPrinterChangeNotification поставщика печати должна вызывать RouterFreePrinterNotifyInfo для освобождения структур, ранее выделенных RouterAllocPrinterNotifyInfo, но только в том случае, если RefreshPrinterChangeNotification обнаруживает ошибку. Если RefreshPrinterChangeNotification успешно завершается, следует предположить, что клиентское приложение освободит структуры.

Помимо освобождения указанной структуры PRINTER_NOTIFY_INFO и связанного с ней массива структуры PRINTER_NOTIFY_INFO_DATA, функция также освобождает буферное пространство, на которое указывает pBuf , в любом элементе массива структуры PRINTER_NOTIFY_INFO_DATA.

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

Требования

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

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

RefreshPrinterChangeNotification

RouterAllocPrinterNotifyInfo