Функция AddPrintProcessor

Статья
06/12/2023

Функция AddPrintProcessor устанавливает обработчик печати на указанном сервере и добавляет имя процессора печати в список поддерживаемых процессоров печати.

Синтаксис

BOOL AddPrintProcessor(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pPathName,
  _In_ LPTSTR pPrintProcessorName
);

Параметры

pName [in]: Указатель на строку, завершающуюся значением NULL, которая указывает имя сервера, на котором должен быть установлен обработчик печати. Если этот параметр имеет значение NULL, обработчик печати устанавливается локально.
pEnvironment [in]: Указатель на строку, завершающуюся значением NULL, которая указывает среду (например, Windows x86, Windows IA64 или Windows x64). Если этот параметр имеет значение NULL, используется текущая среда вызывающего или клиента (не назначения или сервера).
pPathName [in]: Указатель на строку, завершающуюся значением NULL, которая указывает имя файла, содержащего обработчик печати. Этот файл должен находиться в системном каталоге обработчика печати.
pPrintProcessorName [in]: Указатель на строку, завершающуюся нулевым значением, которая указывает имя обработчика печати.

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

Если функция выполняется успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение.

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

Вызывающий объект должен иметь SeLoadDriverPrivilege.

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

Приложение может определить имя существующих процессоров печати, вызвав функцию EnumPrintProcessors .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Winspool.h (включая Windows.h)
Библиотека	Winspool.lib
DLL	Winspool.drv
Имя в кодировке Юникод и ANSI	AddPrintProcessorW (Юникод) и AddPrintProcessorA (ANSI)

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

Вывод на печать
Функции API очереди печати принтера
EnumPrintProcessors
GetPrintProcessorDirectory

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