Método IDelaydC::QueryStations

  • Artículo

El método QueryStations proporciona una lista de todos los equipos que actualmente usan Monitor de red para capturar datos.

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 lista 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
 No había memoria disponible para procesar esta consulta.

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

Consulte también

IDelaydC

QUERYTABLE

STATIONQUERY