IStats::QueryStations-Methode

  • Artikel

Die QueryStations-Methode stellt eine Liste aller Computer bereit, die derzeit Daten mithilfe des Netzwerkmonitors erfassen.

Syntax

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

Parameter

lpQueryTable [ein, aus]

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 diese Informationen möglicherweise Computer enthalten, die Versionen von Network Monitor verwenden, die vor Version 2.0 stehen.

Rückgabewert

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

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

Rückgabecode Beschreibung
NMERR_OUT_OF_MEMORY
 Der für die Verarbeitung dieser Abfrage erforderliche Arbeitsspeicher war nicht 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 der Netzwerkmonitor wartet, bis Remotecomputer auf die Abfrage reagieren. Es können nur Computer im lokalen Subnetz abgefragt werden.

Es liegt in Ihrer Verantwortung, den Arbeitsspeicher für die QUERYTABLE-Struktur zuzuweisen und diesen Arbeitsspeicher freizugeben, 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.

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

IStats

QUERYTABLE

STATIONQUERY