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 |
|---|---|
|
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 |
|
| DLL |
|