IRTC::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]: Zeiger auf ein DWORD, das die Anzahl der für die aktuelle Erfassung aufgezeichneten Sitzungen enthält.
lpSessionStats [out]: Zeiger auf eine SESSIONSTATS-Struktur .
nStations [out]: Zeiger auf ein DWORD, das die Anzahl der Stationen enthält, die für die aktuelle Erfassung aufgezeichnet wurden.
lpStationStats [out]: Zeiger auf eine STATIONSTATS-Struktur .
fClearAfterReading [in]: Flag, das verwendet wird, um Network Monitor anweisen, den internen Speicher der SESSIONSTATS - und STATIONSTATS-Strukturen zu löschen, nachdem die aktuellen Informationen 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 IRTC::Connect auf, um das NPP mit dem Netzwerk zu verbinden.
NMERR_NOT_CAPTURING	Das NPP erfasst keine Daten. Rufen Sie IRTC::Start auf, um die Erfassung zu starten.
NMERR_NOT_REALTIME	Das NPP ist mit dem Netzwerk verbunden, aber nicht mit der IRTC::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 aufgerufen werden, während Sie Daten erfassen. Wenn Sie diese Methode aufrufen, während die aktuelle Erfassung angehalten wird, ist die Methode nicht erfolgreich. Um eine Erfassung zu starten, rufen Sie die IRTC::Start-Methode auf.

Um andere Arten von Statistiken abzurufen, rufen Sie die IRTC::GetTotalStatistics-Methode 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

Weitere Informationen

IRTC
IRTC::Connect
IRTC::GetTotalStatistics
IRTC::Start
SESSIONSTATS
STATIONSTATS

Freigeben über