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

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

OpenPrintProcessor

PrintDocumentOnPrintProcessor