IRTC::QueryStations-Methode

Die QueryStations-Methode stellt eine Liste aller Computer zur Verfügung, die derzeit Netzwerkmonitor, um Netzwerkdaten zu erfassen.

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, die von Netzwerkmonitor werden sollen, und ein Array von STATIONQUERY-Strukturen enthalten.

Bei der Ausgabe gibt diese Struktur die Anzahl der Computer zurück, die Daten erfassen, sowie eine STATIONQUERY-Struktur für jeden gefundenen Computer. Beachten Sie, dass dies Computer umfassen kann, die Versionen von Netzwerkmonitor, die vor Version 2.0 verfügbar sind.

Rückgabewert

Wenn die Methode erfolgreich ist, ist der Rückgabewert NMERR _ SUCCESS.

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

Rückgabecode Beschreibung
NMERR _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
Der zum Verarbeiten 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 einige Sekunden dauern kann, während Netzwerkmonitor auf die Antwort von Remotecomputern auf die Abfrage wartet. Nur Computer im lokalen Subnetz können abgefragt werden.

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

Requirements (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

Weitere Informationen

IRTC

QUERYTABLE

STATIONQUERY