Metodo IStats::GetConversationStatistics

  • Articolo

Il metodo GetConversationStatistics recupera informazioni sulla sessione e sulla stazione sull'acquisizione corrente.

Sintassi

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

Parametri

nSessions [out]

Puntatore a un DWORD contenente il numero di sessioni registrate per l'acquisizione corrente.

lpSessionStats [out]

Puntatore a una struttura SESSIONSTATS .

nStations [out]

Puntatore a un DWORD contenente il numero di stazioni registrate per l'acquisizione corrente.

lpStationStats [out]

Puntatore a una struttura STATIONSTATS .

fClearAfterReading [in]

Flag usato per indicare a Monitoraggio di rete di cancellare l'archiviazione interna delle strutture SESSIONSTATS e STATIONSTATS dopo il recupero dei dati correnti.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene NMERR_SUCCESS.

Se il metodo ha esito negativo, il valore restituito è uno dei codici di errore seguenti:

Codice restituito Descrizione
NMERR_NOT_CONNECTED
 Il NPP non è connesso alla rete. Chiamare IStats::Connect per connettere il NPP alla rete.
NMERR_NOT_CAPTURING
 Il NPP non acquisisce i dati. Chiama IStats::Start per avviare l'acquisizione.
NMERR_NOT_STATS_ONLY
 Il NPP è connesso alla rete, ma non con il metodo IStats::Connect .
NMERR_NO_CONVERSATION_STATS
 La configurazione per questa connessione è impostata su non salvare le statistiche di conversazione. Per salvare le statistiche di conversazione, arrestare l'acquisizione, impostare NoConversationStats = YES nel BLOB di configurazione e quindi riavviare l'acquisizione.

Commenti

Questo metodo può essere chiamato solo mentre è in corso l'acquisizione dei dati; quando l'acquisizione corrente viene sospesa, una chiamata a questo metodo non avrà esito positivo.

Per avviare un'acquisizione, chiamare il metodo IStats::Start . Per recuperare altri tipi di statistiche, chiamare IStats::GetTotalStatistics.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

Vedi anche

IStats

IStats::GetTotalStatistics

IStats::Start

IStats::Connect

SESSIONSTATS

STATIONSTATS