The AddMonitor function installs a local printer monitor and links the configuration, data, and monitor files. Future releases of Windows NT may allow remote installation of printer monitors.
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.
See Also