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

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

Функция InitializePrintMonitor монитора печати инициализирует монитор печати.

Синтаксис

LPMONITOREX InitializePrintMonitor(
  [in] LPWSTR pRegistryRoot
);

Параметры

[in] pRegistryRoot

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

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

Если операция выполнена успешно, функция должна вернуть указатель на структуру MONITOREX . В противном случае функция должна вызвать Метод SetLastError (описанный в документации по Microsoft Windows SDK), чтобы задать код ошибки и вернуть значение NULL.

Комментарии

Функция InitializePrintMonitor должна быть экспортирована языковыми мониторами и библиотеками DLL сервера мониторинга портов. Функция вызывается сразу после загрузки библиотеки DLL монитора и не вызывается повторно, пока библиотека DLL не будет перезагружена. Его цели — позволить монитору инициализировать себя и предоставить диспетчеру очереди указатели на внутренние функции мониторинга. Указатели функций содержатся в структуре MONITOR , на которую ссылается функция MONITOREX .

Параметр pRegistryRoot предоставляет указатель строку, представляющую путь к разделу реестра MonitorName , где MonitorName — это имя монитора, указанное при вызове функции AddMonitor очереди для добавления монитора. Монитор может использовать этот ключ для хранения имен и значений, относящихся к монитору. При вызове функции DeleteMonitor диспетчера очереди удаляет ключ MonitorName и все значения, хранящиеся под ним. (Функции AddMonitor и DeleteMonitor описаны в документации по Windows SDK.)

Требования

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

InitializePrintMonitorUI

MONITOREX