IMonitor：:D oConfigure 方法

  • 项目

DoConfigure 方法必须由监视器实现。 MCSVC 调用此方法以获取捕获的配置信息。

语法

HRESULT STDMETHODCALLTYPE DoConfigure(
  [in]  char *pName,
  [in]  char *pConfiguration,
  [out] char **ppScriptInstance
);

parameters

pName [in]

监视器实例的名称。

pConfiguration [in]

MCSVC 提供的配置字符串。 监视器必须分析此字符串以获取配置数据。

ppScriptInstance [out]

用于配置监视器的 HTML 字符串的地址。 如果使用默认脚本进行配置，则此值应设置为 NULL。

返回值

如果该方法成功，则返回值S_OK (与 NOERROR) 相同，MCSVC 将运行监视器。

如果该方法不成功，则返回值为错误代码。 返回值 NMERR_MONITOR_CONFIG_FAILED 是可接受的，但返回此错误时，在将来的 DoConfigure 调用成功之前，监视器无法启动。 任何其他错误都会导致无法启用监视器实例。

备注

MCSVC 在连接到网络后和 调用 IRTC：：Configure 方法之前调用此方法。

监视器可以存储此调用提供的信息，更新 HTML 脚本或配置字符串，并在 NPP BLOB 中设置 捕获筛选器 。

MCSVC 可能会多次调用此方法，但在监视器捕获数据时不能不调用此方法。 请注意，每次 NPP 启动捕获时，都必须配置与网络的连接。 此限制包括 NPP 启动和停止相同捕获的情况。

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Netmon.h