IStats：：GetConversationStatistics 方法

  • 项目

GetConversationStatistics 方法检索有关当前捕获的会话和工作站信息。

语法

HRESULT STDMETHODCALLTYPE GetConversationStatistics(
  [out] DWORD          *nSessions,
  [out] LPSESSIONSTATS lpSessionStats,
  [out] DWORD          *nStations,
  [out] LPSTATIONSTATS lpStationStats,
  [in]  BOOL           fClearAfterReading
);

parameters

nSessions [out]

指向 DWORD 的指针，该 DWORD 包含为当前捕获记录的 会话 数。

lpSessionStats [out]

指向 SESSIONSTATS 结构的指针。

nStations [out]

指向 DWORD 的指针，该 DWORD 包含为当前捕获记录的 工作站 数。

lpStationStats [out]

指向 STATIONSTATS 结构的指针。

fClearAfterReading [in]

用于指示网络监视器在检索当前数据后清除 SESSIONSTATS 和 STATIONSTATS 结构的内部存储的标志。

返回值

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

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

返回代码 说明
NMERR_NOT_CONNECTED
 NPP 未连接到网络。 调用 IStats：：Connect 将 NPP 连接到网络。
NMERR_NOT_CAPTURING
 NPP 未捕获数据。 调用 IStats：：Start 以启动捕获。
NMERR_NOT_STATS_ONLY
 NPP 连接到网络，但未连接到 IStats：：Connect 方法。
NMERR_NO_CONVERSATION_STATS
 此连接的配置设置为不保存会话统计信息。 若要保存会话统计信息，请停止捕获，在配置 BLOB 中设置 NoConversationStats = YES ，然后重启捕获。

备注

仅当数据捕获正在进行时，才能调用此方法;暂停当前捕获时，对此方法的调用不会成功。

若要开始捕获，请调用 IStats：：Start 方法。 若要检索其他类型的统计信息，请调用 IStats：：GetTotalStatistics。

要求

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

请参阅

IStats

IStats：：GetTotalStatistics

IStats：：Start

IStats：：Connect

SESSIONSTATS

STATIONSTATS