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

Статья
02/07/2025

Функция OpenPrintProcessor обработчика печати подготавливает обработчик печати для печати задания и возвращает дескриптор.

Синтаксис

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Параметры

[in] pPrinterName

Вызывающий указатель на имя принтера, для которого открывается обработчик печати.

[in] pPrintProcessorOpenData

Вызывающий указатель на структуру PRINTPROCESSOROPENDATA.

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

Если операция выполнена успешно, функция должна вернуть дескриптор, который можно использовать в качестве входного аргумента для последующих вызовов PrintDocumentOnPrintProcessor, ControlPrintProcessorи ClosePrintProcessor. Если операция завершается ошибкой, функция должна вызывать SetLastError, чтобы задать код ошибки, а затем вернуть NULL.

Замечания

Процессоры печати необходимы для экспорта функции OpenPrintProcessor. Spooler вызывает функцию, когда задание печати доступно. Функция должна выполнять операции инициализации, необходимые перед обработкой задания на основе типа данных задания.

Функция должна возвращать дескриптор. Как правило, дескриптор является указателем на внутреннюю структуру. Структура должна содержать указатель на имя принтера и указатель на структуру DEVMODEW принтера, оба из которых получены в структуре PRINTPROCESSOROPENDATA. Эти два указателя требуются функции PrintDocumentOnPrintProcessor обработчика печати, и эта последняя функция получает дескриптор в качестве входных данных при вызове spooler.