通过

ExpertIndicateStatus 函数

  • 项目

ExpertIndicateStatus 函数指示专家对捕获文件的分析的完成百分比。

语法

DWORD WINAPI ExpertIndicateStatus(
  _In_  HEXPERTKEY              hExpertKey,
  _In_  EXPERTSTATUSENUMERATION Status,
  _In_  DWORD                   SubStatus,
  _In_  char                    *sztext,
  _Out_ long                    PercentDone
);

参数

hExpertKey [in]

唯一专家标识符。 网络监视器在调用 Run 函数时将 hExpertKey 传递给专家。

状态 [in]

分析的当前状态。 指定以下 EXPERTSTATUSENUMERATION 值之一。

值 含义
EXPERTSTATUS_INACTIVE
 专家从未开始过。
EXPERTSTATUS_STARTING
 专家开始了。
EXPERTSTATUS_RUNNING
 专家运行正常。
EXPERTSTATUS_PROBLEM
 SubStatus 参数中指定的问题停止了专家。
EXPERTSTATUS_ABORTED
 网络监视器阻止了专家。
EXPERTSTATUS_DONE
 专家成功完成了分析。

SubStatus [in]

由 Status 参数提供的信息的扩展或说明。

sztext [in]

可选文本状态指示器。

此参数值可以为 NULL。

PercentDone [out]

专家已处理的捕获数据的百分比。

专家成功完成捕获文件分析后，系统会将百分比设置为 100。 任何大于 99 的数字都会被忽略。

返回值

如果函数成功，则返回值NMERR_SUCCESS。

如果该函数不成功，则返回值NMERR_EXPERT_TERMINATE;专家必须立即清理并返回而不完成捕获。

备注

ExpertIndicateStatus 函数只能由实现 Run 或 Configure 导出函数的专家调用。

要求

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