IStats::Configure 方法

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

语法

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

parameters

hConfigurationBlob [in]

调用方配置的 BLOB 的句柄。

hErrorBlob [out]

包含其他错误信息的错误 BLOB 的句柄。

返回值

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

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

返回代码 说明
NMERR_BLOB_STRING_INVALID
字符串不是以 null 结尾的。
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
已找到类别信息,但未理解。
NMERR_UNKNOWN_TAG
已找到标记信息,但未理解。
NMERR_BLOB_CONVERSION_ERROR
BLOB 已损坏。
NMERR_ILLEGAL_TRIGGER
BLOB 的触发器部分已损坏。

备注

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

请参阅

IStats

ISTATS::Connect

网络监视器 BLOB