Método IStats::QueryStations
El método QueryStations proporciona una lista de todos los equipos que están capturando datos actualmente mediante network Monitor.
Sintaxis
HRESULT STDMETHODCALLTYPE QueryStations(
[in, out] QUERYTABLE *lpQueryTable
);
Parámetros
-
lpQueryTable [in, out]
-
Puntero a una estructura QUERYTABLE . En la entrada, esta estructura debe contener el número máximo de equipos que desea que network Monitor devuelva y una matriz de estructuras STATIONQUERY .
En la salida, esta estructura devuelve el número de equipos que capturan datos y una estructura STATIONQUERY para cada equipo encontrado. Tenga en cuenta que esta información puede incluir equipos que usen versiones de Network Monitor anteriores a la versión 2.0.
Valor devuelto
Si el método se ejecuta correctamente, el valor devuelto se NMERR_SUCCESS.
Si el método no se realiza correctamente, el valor devuelto es el código de error siguiente:
| Código devuelto | Descripción |
|---|---|
|
La memoria necesaria para procesar esta consulta no estaba disponible. |
Observaciones
Este método se puede llamar en cualquier momento después de llamar a CreateNPPInterface . Una llamada a este método es una llamada sincrónica, que puede tardar varios segundos en completarse, ya que Monitor de red espera a que los equipos remotos respondan a la consulta. Solo se pueden consultar los equipos de la subred local.
Es su responsabilidad asignar la memoria para la estructura QUERYTABLE y liberar esa memoria después de que la tabla ya no sea necesaria. Este requisito incluye la memoria necesaria para la matriz STATIONQUERY utilizada en QUERYTABLE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Archivo DLL |
|