IRTC::QueryStations-Methode

Die QueryStations-Methode stellt eine Liste aller Computer bereit, die derzeit den Netzwerkmonitor zum Erfassen von Netzwerkdaten verwenden.

Syntax

HRESULT STDMETHODCALLTYPE QueryStations(
  [in, out] QUERYTABLE *lpQueryTable
);

Parameter

lpQueryTable [in, out]

Ein Zeiger auf eine QUERYTABLE-Struktur . Bei der Eingabe muss diese Struktur die maximale Anzahl von Computern enthalten, die der Netzwerkmonitor zurückgeben soll, und ein Array von STATIONQUERY-Strukturen .

Bei der Ausgabe gibt diese Struktur die Anzahl der Computer zurück, die Daten erfassen, und eine STATIONQUERY-Struktur für jeden gefundenen Computer. Beachten Sie, dass dies möglicherweise Computer mit Versionen des Netzwerkmonitors vor Version 2.0 umfasst.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert NMERR_SUCCESS.

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert einer der folgenden Fehlercodes:

Rückgabecode	Beschreibung
NMERR_OUT_OF_MEMORY	Der für die Verarbeitung dieser Abfrage erforderliche Arbeitsspeicher ist nicht verfügbar.

Bemerkungen

Diese Methode kann jederzeit aufgerufen werden, nachdem die CreateNPPInterface-Methode aufgerufen wurde. Ein Aufruf dieser Methode ist ein synchroner Aufruf, der mehrere Sekunden dauern kann, während der Netzwerkmonitor darauf wartet, dass Remotecomputer auf die Abfrage reagieren. Es können nur Computer im lokalen Subnetz abgefragt werden.

Der Benutzer muss den Arbeitsspeicher für die QUERYTABLE-Struktur zuordnen und diesen Arbeitsspeicher freigeben, nachdem die Tabelle nicht mehr benötigt wird. Diese Anforderung umfasst den für das in QUERYTABLE verwendeten STATIONQUERY-Array erforderlichen Arbeitsspeicher.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Netmon.h
DLL	Ndisnpp.dll; Rmtnpp.dll

Siehe auch

IRTC

QUERYTABLE

STATIONQUERY