AddMonitor 函数

AddMonitor 函数安装本地端口监视器，并链接配置、数据和监视器文件。

语法

BOOL AddMonitor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pMonitors
);

pName [in]

指向以 null 结尾的字符串的指针，该字符串指定应安装监视器的服务器的名称。对于仅支持本地安装的监视器的系统，此字符串应为 NULL。

级别 [in]

pMonitors 指向的结构的版本。此值必须为 2。

pMonitors [in]

指向 MONITOR_INFO_2 结构的指针。如果 pMonitors 结构的 pEnvironment 成员为 NULL，则使用调用方 (客户端) 的当前环境，而不是目标 (服务器) 的环境。

请注意，如果环境与服务器环境不匹配，则调用将失败，也就是说，只能添加为服务器的体系结构编写的监视器。

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

注意

这是一个阻塞或同步函数，可能不会立即返回。此函数的返回速度取决于运行时因素，例如网络状态、打印服务器配置以及编写应用程序时难以预测的打印机驱动程序实现因素。从管理与用户界面交互的线程调用此函数可能会使应用程序看起来无响应。

调用方必须具有 SeLoadDriverPrivilege。

在应用程序调用 AddMonitor 函数之前，监视器所需的所有文件都必须复制到 SYSTEM32 目录。

若要确定当前安装的端口监视器，请调用 EnumMonitors 函数。

若要删除 AddMonitor 添加的监视器，请调用 DeleteMonitor 函数。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Winspool.h (包括 Windows.h)
库	Winspool.lib
DLL	Winspool.drv
Unicode 和 ANSI 名称	AddMonitorW (Unicode) 和 AddMonitorA (ANSI)