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