IStats::GetConversationStatistics-Methode

Die GetConversationStatistics-Methode ruft Sitzungs- und Stationsinformationen zur aktuellen Erfassung ab.

Syntax

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

Parameter

nSessions [ out]

Ein Zeiger auf ein DWORD, das die Anzahl der für die aktuelle Erfassung aufgezeichneten Sitzungen enthält.

lpSessionStats [ out]

Ein Zeiger auf eine SESSIONSTATS-Struktur.

nStations [ out]

Ein Zeiger auf ein DWORD, das die Anzahl der für die aktuelle Erfassung aufgezeichneten Stationen enthält.

lpStationStats [ out]

Ein Zeiger auf eine STATIONSTATS-Struktur.

fClearAfterReading [ In]

Flag, das verwendet wird, um Netzwerkmonitor, den internen Speicher der SESSIONSTATS- und STATIONSTATS-Strukturen zu löschen, nachdem die aktuellen Daten abgerufen wurden.

Rückgabewert

Wenn die Methode erfolgreich ist, ist der Rückgabewert NMERR _ SUCCESS.

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert einer der folgenden Fehlercodes:

Rückgabecode Beschreibung
NMERR _ NICHT _ VERBUNDEN
Der NPP ist nicht mit dem Netzwerk verbunden. Rufen Sie IStats::Verbinden auf, um das NPP mit dem Netzwerk zu verbinden.
NMERR NOT CAPTURING (NMERR _ WIRD NICHT _ ERFASST)
Der NPP erfasst keine Daten. Rufen Sie IStats::Start auf, um die Erfassung zu starten.
NMERR _ NICHT _ NUR STATISTIKEN _
Das NPP ist mit dem Netzwerk verbunden, jedoch nicht mit der IStats::Verbinden-Methode.
NMERR _ NO _ CONVERSATION _ STATS
Die Konfiguration für diese Verbindung ist so festgelegt, dass konversationsstatistiken nicht gespeichert werden. Um Konversationsstatistiken zu speichern, beenden Sie die Erfassung, legen Sie NoConversationStats = YES im Konfigurationsblob fest, und starten Sie die Erfassung neu.

Bemerkungen

Diese Methode kann nur während der Datenerfassung aufgerufen werden. Wenn die aktuelle Erfassung angehalten wird, ist ein Aufruf dieser Methode nicht erfolgreich.

Um eine Erfassung zu starten, rufen Sie die IStats::Start-Methode auf. Rufen Sie zum Abrufen anderer Statistiktypen IStats::GetTotalStatistics auf.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

Weitere Informationen

IStats

IStats::GetTotalStatistics

IStats::Start

IStats::Verbinden

SESSIONSTATS

STATIONSTATS