IRTC：：Configure 方法

  • 项目

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

语法

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

parameters

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：：Connect

网络监视器 BLOB