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 |
|---|---|
|
Der NPP ist nicht mit dem Netzwerk verbunden. Rufen Sie IStats::Verbinden auf, um das NPP mit dem Netzwerk zu verbinden. |
|
Der NPP erfasst keine Daten. Rufen Sie IStats::Start auf, um die Erfassung zu starten. |
|
Das NPP ist mit dem Netzwerk verbunden, jedoch nicht mit der IStats::Verbinden-Methode. |
|
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 |
|
| DLL |
|