通过

IESP：：Configure 方法

  • 项目

Configure 方法提交捕获的配置信息。

语法

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

参数

hConfigurationBlob [in]

调用方配置的 BLOB 的句柄。

hErrorBlob [out]

包含其他错误信息的错误 BLOB 的句柄。 有关错误 BLOB 的内容的信息，请参阅本主题中的“备注”部分。

返回值

如果该方法成功，则返回值NMERR_SUCCESS。

如果该方法不成功，则返回值为以下错误代码之一：

返回代码 说明
NMERR_NOT_CONNECTED
 NPP 未连接到网络。
NMERR_NOT_ESP
 NPP 连接到网络，但未连接到 IESP：：Connect 方法。
NMERR_CAPTURING
 NPP 报告捕获会话已启动。
NMERR_ILLEGAL_TRIGGER
 配置 BLOB 的触发器部分已损坏。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 hConfigurationBlob 指定的配置 BLOB 缺少执行此操作所需的条目。 查看 hErrorBlob 返回的错误 BLOB 以确定找不到哪个条目。
NMERR_BLOB_CONVERSION_ERROR
 BLOB 已损坏。
NMERR_BLOB_NOT_INITIALIZED
 尚未调用 CreateBlob 方法。
NMERR_INVALID_BLOB
 指向的对象不是 BLOB。
NMERR_BLOB_STRING_INVALID
 字符串不是以 null 结尾的。
NMERR_UPLEVEL_BLOB
 BLOB 版本号不正确。
NMERR_OUT_OF_MEMORY
 没有可用的内存。 关闭窗口以释放资源。
NMERR_TIMEOUT
 请求已超时。

备注

必须应用此方法来重启已启动和停止但未断开连接的 NPP。

hErrorBlob 参数返回的错误 BLOB 包含网络监视器在 hConfigurationBlob 中指定的配置 BLOB 中无法理解或查找的条目。 返回的错误 BLOB 包含应用程序可用于故障排除的错误信息。 例如，如果返回NMERR_BLOB_ENTRY_DOES_NOT_EXIST，则返回的错误 BLOB 中包含网络监视器找不到的条目。

要求

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