IDelaydC::QueryStations-Methode

Die QueryStations-Methode stellt eine Liste aller Computer zur Verfügung, die derzeit Netzwerkmonitor zum Erfassen von Daten verwenden.

Syntax

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

Parameter

lpQueryTable [ in, out]

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, und eine STATIONQUERY-Struktur für jeden gefundenen Computer. Beachten Sie, dass diese Liste Computer mit Versionen von Netzwerkmonitor, die vor Version 2.0 stehen, enthalten kann.

Rückgabewert

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

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert der folgende Fehlercode:

Rückgabecode Beschreibung
NMERR _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
Zum Verarbeiten dieser Abfrage war kein Arbeitsspeicher verfügbar.

Bemerkungen

Diese Methode kann jederzeit aufgerufen werden, nachdem CreateNPPInterface aufgerufen wurde. Ein Aufruf dieser Methode ist ein synchroner Aufruf, der einige Sekunden dauern kann, da Netzwerkmonitor auf die Antwort der Remotecomputer auf die Abfrage wartet. Nur Computer im lokalen Subnetz können abgefragt werden.

Es liegt in Ihrer Verantwortung, den Arbeitsspeicher für die QUERYTABLE-Struktur zu reservieren und diesen Freispeicher frei zu 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

IDelaydC

QUERYTABLE

STATIONQUERY