Méthode IRTC::QueryStations
La méthode QueryStations fournit une liste de tous les ordinateurs qui utilisent actuellement le 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 le Moniteur réseau doit retourner et un tableau de structures STATIONQUERY .
En sortie, cette structure retourne le nombre d’ordinateurs capturant des données et une structure STATIONQUERY pour chaque ordinateur trouvé. N’oubliez pas que cela peut inclure des ordinateurs utilisant des versions du Moniteur réseau antérieures à 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 l’un des codes d’erreur suivants :
| Code de retour | Description |
|---|---|
|
La mémoire nécessaire pour traiter cette requête n’est 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 pendant que le Moniteur réseau attend que les ordinateurs distants répondent à la requête. Seuls les ordinateurs du sous-réseau local peuvent être interrogés.
L’utilisateur doit allouer la mémoire pour la structure QUERYTABLE et libérer cette mémoire une fois 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 |
|
| DLL |
|