AddMonitor
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