Функция 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 |