IDelaydC::QueryStations, méthode

La méthode QueryStations fournit une liste de tous les ordinateurs qui utilisent actuellement Network Monitor pour capturer des données.

Syntaxe

HRESULT STDMETHODCALLTYPE QueryStations(
  [in, out] QUERYTABLE *lpQueryTable
);

Paramètres

lpQueryTable [in, out]

Pointeur vers une structure QUERYTABLE . En entrée, cette structure doit contenir le nombre maximal d’ordinateurs que vous souhaitez renvoyer et un tableau de structures STATIONQUERY .

En sortie, cette structure retourne le nombre d’ordinateurs qui capturent des données et une structure STATIONQUERY pour chaque ordinateur trouvé. Notez que cette liste peut inclure des ordinateurs utilisant des versions de Network Monitor qui précèdent la version 2.0.

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_OUT_OF_MEMORY
Aucune mémoire n’a été disponible pour traiter cette requête.

Notes

Cette méthode peut être appelée à tout moment après l’appel de CreateNPPInterface . Un appel à cette méthode est un appel synchrone, qui peut prendre plusieurs secondes pour s’effectuer en attendant que le moniteur réseau attend que les ordinateurs distants répondent à la requête. Seuls les ordinateurs sur le sous-réseau local peuvent être interrogés.

Il est de votre responsabilité d’allouer la mémoire à la structure QUERYTABLE et de libérer cette mémoire après que la table n’est plus nécessaire. Cette exigence inclut la mémoire nécessaire pour le tableau STATIONQUERY utilisé dans QUERYTABLE.

Configuration requise

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

IDelaydC

QUERYTABLE

STATIONQUERY