Méthode IStats::QueryStatus

La méthode QueryStatus récupère les status du NPP.

Syntaxe

HRESULT STDMETHODCALLTYPE QueryStatus(
  [out] NETWORKSTATUS *pNetworkStatus
);

Paramètres

pNetworkStatus [out]

Pointeur vers une structure NETWORKSTATUS retournée qui indique l’état actuel (capture, pause, arrêt, etc.) du NPP. Il incombe à l’application d’allouer et de libérer la mémoire pour la structure NETWORKSTATUS .

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 le code d’erreur suivant :

Code de retour	Description
NMERR_INVALID_PARAMETER	Le paramètre pNetworkStatus ne pointe pas vers une structure NETWORKSTATUS valide. Allouez de la mémoire pour cette structure et appelez à nouveau la méthode IStats::QueryStatus .

Notes

Cette méthode peut être appelée à tout moment après l’appel de la méthode CreateNPPInterface . Il peut être appelé pour voir si le NPP est connecté au réseau, pour connaître les status de la capture actuelle et pour voir si des déclencheurs sont en attente. Toutefois, avant d’appeler cette méthode, vous devez allouer la mémoire nécessaire à la structure NETWORKSTATUS et libérer cette mémoire lorsque la structure n’est plus nécessaire.

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

CreateNPPInterface

NETWORKSTATUS