IRTC::QueryStations (método)

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

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 esto puede incluir equipos que usan versiones de Network Monitor anteriores a la versión 2.0.

Valor devuelto

Si el método se ejecuta correctamente, el valor devuelto es NMERR_SUCCESS.

Si el método no se realiza correctamente, el valor devuelto es uno de los siguientes códigos de error:

Código devuelto	Descripción
NMERR_OUT_OF_MEMORY	La memoria necesaria para procesar esta consulta no está disponible.

Observaciones

Este método se puede llamar en cualquier momento después de llamar al método CreateNPPInterface . Una llamada a este método es una llamada sincrónica, que puede tardar varios segundos en completarse mientras Network Monitor espera a que los equipos remotos respondan a la consulta. Solo se pueden consultar los equipos de la subred local.

El usuario debe 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 usada 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

IRTC

QUERYTABLE

STATIONQUERY