The EnumMonitors function initializes an array of structures with data describing the monitors for the specified server.
BOOL EnumMonitors(
| LPTSTR pName, | // pointer to server name |
| DWORD Level, | // structure level |
| LPBYTE pMonitors, | // pointer to structure array |
| DWORD cbBuf, | // size, in bytes, of buffer |
| LPDWORD pcbNeeded, | // addr. of variable with no. of bytes copied (or required) |
| LPDWORD pcReturned | // addr. of variable with no. of job info. structures copied |
| ); |
Parameters
pName
Points to a null-terminated string that specifies the name of the server on which the monitors reside. If this parameter is NULL, the local monitors are enumerated.
Level
Specifies the version of the structure pointed to by pMonitors.
pMonitors
Points to an array of MONITOR_INFO_1 or MONITOR_INFO_2 structures.
cbBuf
Specifies the size, in bytes, of the buffer pointed to by pMonitors.
pcbNeeded
Points to a variable that receives the number of bytes copied if the function succeeds or the number of bytes required if cbBuf is too small.
pcReturned
Points to a variable that receives the number of structures that were returned in the buffer pointed to by pMonitors.
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.
See Also