Método IStats::GetConversationStatistics

El método GetConversationStatistics recupera información de sesión y estación sobre la captura actual.

Sintaxis

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

Parámetros

nSessions [out]

Puntero a un DWORD que contiene el número de sesiones registradas para la captura actual.

lpSessionStats [out]

Puntero a una estructura SESSIONSTATS .

nStations [out]

Puntero a un DWORD que contiene el número de estaciones registradas para la captura actual.

lpStationStats [out]

Puntero a una estructura STATIONSTATS .

fClearAfterReading [in]

Marca que se usa para indicar a Network Monitor que borre el almacenamiento interno de las estructuras SESSIONSTATS y STATIONSTATS después de recuperar los datos actuales.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto se NMERR_SUCCESS.

Si el método no se realiza correctamente, el valor devuelto es uno de los siguientes códigos de error:

Código devuelto	Descripción
NMERR_NOT_CONNECTED	El NPP no está conectado a la red. Llame a IStats::Connect para conectar el NPP a la red.
NMERR_NOT_CAPTURING	El NPP no captura datos. Llame a IStats::Start para iniciar la captura.
NMERR_NOT_STATS_ONLY	El NPP está conectado a la red, pero no con el método IStats::Connect .
NMERR_NO_CONVERSATION_STATS	La configuración de esta conexión se establece en no guardar las estadísticas de conversación. Para guardar las estadísticas de conversación, detenga la captura, establezca NoConversationStats = YES en el BLOB de configuración y reinicie la captura.

Comentarios

Solo se puede llamar a este método mientras la captura de datos está en curso; cuando la captura actual está en pausa, una llamada a este método no se realizará correctamente.

Para iniciar una captura, llame al método IStats::Start . Para recuperar otros tipos de estadísticas, llame a IStats::GetTotalStatistics.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Archivo DLL	Ndisnpp.dll; Rmtnpp.dll

Consulte también

IStats

IStats::GetTotalStatistics

IStats::Start

IStats::Connect

SESSIONSTATS

STATIONSTATS