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

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

  • Статья

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

Синтаксис

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

Параметры

hPrinter

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

pDataSrc

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

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

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

Комментарии

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

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

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

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

Требования

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

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

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification