Поделиться через


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

Функция spooler печати PartialReplyPrinterChangeNotification позволяет поставщику печати обновить базу данных spooler изменений принтера, связанных с дескриптором уведомлений.

Синтаксис

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

Параметры

hPrinter

Предоставленный вызывающим дескриптором. Этот дескриптор должен быть ранее получен в качестве входных данных hNotify для функции поставщика печати FindFirstPrinterChangeNotification.

pDataSrc

Вызывающий указатель на структуру PRINTER_NOTIFY_INFO_DATA (описанную в документации по пакету SDK для Microsoft Windows). Может быть значение NULL. Дополнительные сведения см. в следующем разделе "Примечания".

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

Если операция выполнена успешно, функция возвращает TRUE. В противном случае функция возвращает FALSE. Вызывающий объект может получить код ошибки, вызвав GetLastError.

Замечания

Для указанного дескри птора уведомлений функция spooler PartialReplyPrinterChangeNotification добавляет содержимое указанной структуры PRINTER_NOTIFY_INFO_DATA в массив в хранимой PRINTER_NOTIFY_INFO структуре spooler. (Эти структуры описаны в документации по пакету SDK для Windows.)

Вызов PartialReplyPrinterChangeNotification не приводит к тому, что spooler уведомляет приложение о том, что произошли изменения. Если функция поставщика печати FindFirstPrinterChangeNotification не установила флаг PRINTER_NOTIFY_STATUS_POLL, поставщик должен вызвать ReplyPrinterChangeNotification, чтобы приложение было уведомлено.

Если pInfoDataSrcNULL, все сохраненные сведения, связанные с указанным дескриптором, удаляются из spooler. Функция выполняет это удаление путем освобождения всех буферов, связанных с pBuf членов структур PRINTER_NOTIFY_INFO_DATA, принадлежащих указанному дескриптору. Затем функция задает флаг PRINTER_NOTIFY_INFO_DISCARDED в сохраненной PRINTER_NOTIFY_INFO структуре.

Дополнительные сведения см. в уведомления о смене принтера.

Требования

Требование Ценность
целевая платформа Настольный
заголовка winsplp.h (include Winsplp.h)
библиотеки Spoolss.lib
DLL Spoolss.dll

См. также

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification