Méthode IStats::GetConversationStatistics

  • Article

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