IRTC::Configure 方法

Configure 方法提交数据捕获的配置数据。

语法

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

参数

hConfigurationBlob [in]

调用方配置的 BLOB 的句柄。

hErrorBlob [out]

包含其他错误数据的错误 BLOB 的句柄。

返回值

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

如果方法失败,则返回值是以下错误代码之一:

返回代码 说明
NMERR_BLOB_NOT_INITIALIZED
尚未调用 CreateBlob 方法。
NMERR_INVALID_BLOB
指向的对象不是 BLOB。
NMERR_UPLEVEL_BLOB
BLOB 版本号不正确。
NMERR_BLOB_ENTRY_ALREADY_EXISTS
重复的 BLOB。
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
hConfigurationBlob 指定的配置 BLOB 缺少执行此操作所需的条目。 查看 hErrorBlob 返回的错误 BLOB 以确定找不到哪个条目。
NMERR_AMBIGUOUS_SPECIFIER
缺少 BLOB 所有者或类别数据。
NMERR_BLOB_OWNER_NOT_FOUND
找不到 BLOB 所有者部分。
NMERR_BLOB_CATEGORY_NOT_FOUND
找不到 BLOB 类别部分。
NMERR_UNKNOWN_CATEGORY
找到 BLOB 类别部分,但无法理解。
NMERR_UNKNOWN_TAG
找到 BLOB 标记部分,但无法理解。
NMERR_BLOB_CONVERSION_ERROR
BLOB 已损坏。
NMERR_ILLEGAL_TRIGGER
BLOB 的触发器部分已损坏。
NMERR_BLOB_STRING_INVALID
字符串不是以 null 结尾的。

备注

必须应用此方法才能重启已启动、停止但未断开连接的 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

另请参阅

IRTC

IRTC::连接

网络监视器 BLOB