Método IStats::QueryStations

  • Artículo

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
NMERR_OUT_OF_MEMORY
 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
Netmon.h
Archivo DLL
Ndisnpp.dll;
Rmtnpp.dll

Vea también

IStats

QUERYTABLE

STATIONQUERY