IESP :: QueryStations, méthode
La méthode QueryStations fournit la liste de tous les ordinateurs qui utilisent actuellement Moniteur réseau pour capturer les données réseau.
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 Moniteur réseau retourner et un tableau de structures STATIONQUERY .
Lors de la sortie, cette structure retourne le nombre d’ordinateurs qui capturent des données et une structure STATIONQUERY pour chaque ordinateur trouvé. Notez que ce total peut inclure des ordinateurs utilisant des versions de Moniteur réseau qui prédatent la version 2,0.
Valeur de retour
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 |
|---|---|
|
La mémoire nécessaire pour traiter cette requête n’était pas disponible. |
Notes
Cette méthode peut être appelée à tout moment après l’appel de la méthode CreateNPPInterface . Un appel à cette méthode est un appel synchrone, qui peut prendre plusieurs secondes pour s’exécuter 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 vous incombe d’allouer la mémoire pour la structure QUERYTABLE et de libérer de la mémoire une fois que la table n’est plus nécessaire. Cette exigence comprend la mémoire nécessaire pour le tableau STATIONQUERY utilisé dans QUERYTABLE.
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 |
|
| DLL |
|