IDelaydC::QueryStations-Methode

Die QueryStations-Methode bietet eine Liste aller Computer, die derzeit Netzwerkmonitor verwenden, um Daten zu erfassen.

Syntax

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

Parameter

lpQueryTable [in, out]

Zeiger auf eine QUERYTABLE-Struktur . Bei eingaben muss diese Struktur die maximale Anzahl von Computern enthalten, die Netzwerkmonitor zurückgeben und ein Array von STATIONQUERY-Strukturen zurückgeben möchten.

In der Ausgabe gibt diese Struktur die Anzahl der Computer zurück, die Daten erfassen und eine STATIONQUERY-Struktur für jeden Computer gefunden haben. Beachten Sie, dass diese Liste Computer mithilfe von Versionen von Netzwerkmonitor enthalten kann, die version 2.0 voreingestellt sind.

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_OUT_OF_MEMORY
Es ist kein Speicher verfügbar, um diese Abfrage zu verarbeiten.

Bemerkungen

Diese Methode kann jederzeit aufgerufen werden, nachdem CreateNPPInterface aufgerufen wird. Ein Aufruf dieser Methode ist ein synchroner Aufruf, der mehrere Sekunden dauern kann, bis der Netzwerkmonitor auf Remotecomputer wartet, um auf die Abfrage zu reagieren. Nur Computer im lokalen Subnetz können abgefragt werden.

Es ist Ihre 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 Speicher, der für das STATIONQUERY-Array erforderlich ist, das in QUERYTABLE verwendet 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

Siehe auch

IDelaydC

QUERYTABLE

STATIONQUERY