Méthode IStats::GetConversationStatistics

Article
06/13/2023

La méthode GetConversationStatistics récupère les informations de session et de station sur la capture actuelle.

Syntaxe

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

Paramètres

nSessions [out]: Pointeur vers un DWORD qui contient le nombre de sessions enregistrées pour la capture actuelle.
lpSessionStats [out]: Pointeur vers une structure SESSIONSTATS .
nStations [out]: Pointeur vers un DWORD qui contient le nombre de stations enregistrées pour la capture actuelle.
lpStationStats [out]: Pointeur vers une structure STATIONSTATS .
fClearAfterReading [in]: Indicateur utilisé pour indiquer au Moniteur réseau d’effacer le stockage interne des structures SESSIONSTATS et STATIONSTATS une fois les données actuelles récupérées.

Valeur retournée

Si la méthode réussit, la valeur de retour est NMERR_SUCCESS.

Si la méthode échoue, la valeur de retour est l’un des codes d’erreur suivants :

Code de retour	Description
NMERR_NOT_CONNECTED	Le NPP n’est pas connecté au réseau. Appelez IStats::Connect pour connecter le NPP au réseau.
NMERR_NOT_CAPTURING	Le NPP ne capture pas de données. Appelez IStats::Start pour démarrer la capture.
NMERR_NOT_STATS_ONLY	Le NPP est connecté au réseau, mais pas avec la méthode IStats::Connect .
NMERR_NO_CONVERSATION_STATS	La configuration de cette connexion est définie de manière à ne pas enregistrer les statistiques de conversation. Pour enregistrer les statistiques de conversation, arrêtez la capture, définissez NoConversationStats = YES dans l’objet BLOB de configuration, puis redémarrez la capture.

Notes

Cette méthode ne peut être appelée que lorsque la capture de données est en cours ; lorsque la capture actuelle est suspendue, un appel à cette méthode ne réussit pas.

Pour démarrer une capture, appelez la méthode IStats::Start . Pour récupérer d’autres types de statistiques, appelez IStats::GetTotalStatistics.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Netmon.h
DLL	Ndisnpp.dll; Rmtnpp.dll

Voir aussi

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

Partager via