AddMonitor

The AddMonitor function installs a local printer monitor and links the configuration, data, and monitor files.

BOOL AddMonitor(
  LPTSTR pName,      // pointer to server name
  DWORD Level,       // monitor info. structure level
  LPBYTE pMonitors   // pointer to monitor info. structure
);
 

Parameters

pName

Pointer to a null-terminated string that specifies the name of the server on which the monitor should be installed. For this release of Windows NT, monitors may only be installed locally, so this string should be NULL.

Level

Specifies the version of the structure to which pMonitors points. This value must be 2.

pMonitors

Pointer to a MONITOR_INFO_2 structure.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

Before an application calls the AddMonitor function, all files required by the monitor must be copied to the SYSTEM32 directory.

An application can determine which printer monitors are currently installed by calling the EnumMonitors function.

A monitor added by AddMonitor may be removed by calling DeleteMonitor.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winspool.h.
  Import Library: Use winspool.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Functions, DeleteMonitor, EnumMonitors, MONITOR_INFO_2