IStats::GetConversationStatistics-Methode

Artikel
06/13/2023

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 Stationen enthält, die für die aktuelle Erfassung aufgezeichnet wurden.
lpStationStats [out]: Ein Zeiger auf eine STATIONSTATS-Struktur .
fClearAfterReading [in]: Flag, das verwendet wird, um Network Monitor anzuweisen, den internen Speicher der SESSIONSTATS- und STATIONSTATS-Strukturen zu löschen, nachdem die aktuellen Daten abgerufen wurden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert NMERR_SUCCESS.

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

Rückgabecode	Beschreibung
NMERR_NOT_CONNECTED	Das NPP ist nicht mit dem Netzwerk verbunden. Rufen Sie IStats::Connect auf, um das NPP mit dem Netzwerk zu verbinden.
NMERR_NOT_CAPTURING	Das NPP erfasst keine Daten. Rufen Sie IStats::Start auf, um die Erfassung zu starten.
NMERR_NOT_STATS_ONLY	Das NPP ist mit dem Netzwerk verbunden, aber nicht mit der IStats::Connect-Methode .
NMERR_NO_CONVERSATION_STATS	Die Konfiguration für diese Verbindung ist so festgelegt, dass Unterhaltungsstatistiken nicht gespeichert werden. Um Unterhaltungsstatistiken zu speichern, beenden Sie die Erfassung, legen Sie NoConversationStats = YES im Konfigurationsblob fest, und starten Sie dann 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. Um andere Arten von Statistiken abzurufen, rufen Sie IStats::GetTotalStatistics auf.

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

Siehe auch

IStats
IStats::GetTotalStatistics
IStats::Start
IStats::Connect
SESSIONSTATS
STATIONSTATS

Freigeben über