Функция ControlPrintProcessor (winsplp.h)
Функция ControlPrintProcessor обработчика печати позволяет диспетчеру очереди печати управлять заданием печати.
Синтаксис
BOOL ControlPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] DWORD Command
);
Параметры
[in] hPrintProcessor
Дескриптор процессора, предоставленный вызывающим абонентом. Это дескриптор, возвращенный предыдущим вызовом OpenPrintProcessor.
[in] Command
Команда, предоставляемая вызывающей стороны, указывающая тип выполняемой операции. Допустимы следующие команды:
| Get-Help | Определение |
|---|---|
| JOB_CONTROL_CANCEL | Функция должна отменить текущее задание печати. |
| JOB_CONTROL_PAUSE | Функция должна приостановить текущее задание печати. |
| JOB_CONTROL_RESUME | Функция должна возобновить текущее задание печати. |
Возвращаемое значение
Если операция выполнена успешно, функция должна вернуть значение TRUE. Если операция завершается сбоем, функция должна вызвать SetLastError, чтобы задать код ошибки, а затем вернуть значение FALSE.
Комментарии
Для экспорта функции ControlPrintProcessor требуются процессоры печати. Очередь очереди вызывает функцию, когда приложение вызывает функцию SetJob, описанную в документации по Microsoft Windows SDK.
В зависимости от значения, полученного в параметре Command, функция должна приостановить, возобновить или отменить текущее задание. Функция ControlPrintProcessor может вызываться асинхронно во время выполнения функции PrintDocumentOnPrintProcessor обработчика печати. Таким образом, необходимо использовать какой-либо метод синхронизации, например, задать внутренне определенный объект события для приостановки задания и сбросить объект события при возобновлении задания. Функция ControlPrintProcessor может быстро вернуться после установки или сброса объекта события, а PrintDocumentOnPrintProcessor может ждать, пока событие будет находиться в правильном состоянии.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | winsplp.h (включая Winsplp.h) |
| Библиотека | Nwprint.lib |