Méthode IRTC::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 après avoir récupéré les informations actuelles.

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 IRTC::Connect pour connecter le NPP au réseau.
NMERR_NOT_CAPTURING	Le NPP ne capture pas de données. Appelez IRTC::Start pour démarrer la capture.
NMERR_NOT_REALTIME	Le NPP est connecté au réseau, mais pas avec la méthode IRTC::Connect .
NMERR_NO_CONVERSATION_STATS	La configuration de cette connexion est définie pour 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 vous capturez des données ; si vous appelez cette méthode alors que la capture actuelle est suspendue, la méthode échoue. Pour démarrer une capture, appelez la méthode IRTC::Start .

Pour récupérer d’autres types de statistiques, appelez la méthode IRTC::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

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

Partager via