Функция AddMonitor

Статья
06/12/2023

Функция AddMonitor устанавливает локальный монитор портов и связывает файлы конфигурации, данных и монитора.

Синтаксис

BOOL AddMonitor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pMonitors
);

Параметры

pName [in]

Указатель на строку, завершающуюся значением NULL, которая указывает имя сервера, на котором должен быть установлен монитор. Для систем, поддерживающих только локальную установку мониторов, эта строка должна иметь значение NULL.

Level [in]

Версия структуры, на которую указывает pMonitors . Это значение должно быть равно 2.

pMonitors [in]

Указатель на структуру MONITOR_INFO_2 . Если элемент pEnvironment структуры pMonitors имеет значение NULL, используется текущая среда вызывающего объекта (клиента), а не назначения (сервера).

Обратите внимание, что вызов завершится ошибкой, если среда не соответствует среде сервера, то есть можно добавить только монитор, написанный для архитектуры сервера.

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

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

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

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

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

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

Чтобы определить мониторы портов, которые установлены в данный момент, вызовите функцию EnumMonitors .

Чтобы удалить монитор, добавленный AddMonitor, вызовите функцию DeleteMonitor .

Требования

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

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

Вывод на печать
Функции API очереди печати принтера
DeleteMonitor
EnumMonitors
MONITOR_INFO_2

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