描述
EnumMonitors功能检索有关指定服务器上安装的端口监视器的信息。
C++ 语法
BOOL EnumMonitors( __in LPTSTR pName, __in DWORD Level, __out LPBYTE pMonitors, __in DWORD cbBuf, __out LPDWORD pcbNeeded, __out LPDWORD pcReturned ); |
PowerBASIC 语法
FUNCTION EnumMonitorsA ( _ BYREF pName AS ASCIIZ, _ BYVAL Level AS DWORD, _ BYREF pMonitors AS ANY, _ BYVAL cbBuf AS DWORD, _ BYREF pcbNeeded AS DWORD, _ BYREF pcReturned AS DWORD _ ) AS LONG |
Unicode版本:
FUNCTION EnumMonitorsW ( _ BYREF pName AS WSTRINGZ, _ BYVAL Level AS DWORD, _ BYREF pMonitors AS ANY, _ BYVAL cbBuf AS DWORD, _ BYREF pcbNeeded AS DWORD, _ BYREF pcReturned AS DWORD _ ) AS LONG |
参数
pName
[in]指向指定显示器所在服务器名称的以null结尾的字符串的指针。如果此参数为NULL，则枚举本地监视器。
Level
[in]指定pMonitors指向的结构的版本。
Windows NT / 2000 / XP / Vista / Windows 7：此值可以是1或2。
Windows 95/98 / Me：此值必须为1。
pMonitors
[out]指向接收结构数组的缓冲区的指针。缓冲区必须足够大以存储由结构成员引用的字符串。
要确定所需的缓冲区大小，请使用cbBuf设置为零调用EnumMonitors.EnumMonitors失败，GetLastError返回ERROR_INSUFFICIENT_BUFFER，pcbNeeded参数返回保存结构数组及其数据所需的缓冲区大小（以字节为单位）。
Windows NT / 2000 / XP / Vista / Windows 7：如果水平为1，则缓冲区接收MONITOR_INFO_1结构的数组，否则MONITOR_INFO_2为MONITOR_INFO_2结构。
Windows 95/98 / Me：如果水平为1，则缓冲区接收MONITOR_INFO_1结构的数组。
cbBuf
[in]指定由pMonitors指向的缓冲区的大小（以字节为单位）。
pcbNeeded
[out]指向变量的指针，如果函数成功，则接收复制的字节数，如果cbBuf太小，则需要的字节数。
pcReturned
[out]指向一个变量的指针，该变量接收pMonitors指向的缓冲区中返回的结构数。
返回值
如果函数成功，则返回值为非零值。
如果函数失败，返回值为零。
引用文件 #INCLUDE Once
WinSpool.inc（包括Windows.inc）