Metodo IESP::QueryStations

Il metodo QueryStations fornisce un elenco di tutti i computer che attualmente usano Monitoraggio di rete per acquisire i dati di rete.

Sintassi

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

Parametri

lpQueryTable [in, out]

Puntatore a una struttura QUERYTABLE . In input, questa struttura deve contenere il numero massimo di computer da restituire e una matrice di strutture STATIONQUERY .

In output, questa struttura restituisce il numero di computer che acquisiscono dati e una struttura STATIONQUERY per ogni computer trovato. Si noti che questo totale può includere computer che usano versioni di Monitoraggio di rete che precedono la versione 2.0.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è NMERR_SUCCESS.

Se il metodo ha esito negativo, il valore restituito è il codice di errore seguente:

Codice restituito	Descrizione
NMERR_OUT_OF_MEMORY	Memoria necessaria per elaborare questa query non disponibile.

Commenti

Questo metodo può essere chiamato in qualsiasi momento dopo che viene chiamato il metodo CreateNPPInterface . Una chiamata a questo metodo è una chiamata sincrona, che può richiedere diversi secondi per completare come Monitoraggio di rete attende che i computer remoti rispondano alla query. È possibile eseguire query solo sui computer nella subnet locale.

È responsabilità dell'utente allocare la memoria per la struttura QUERYTABLE e liberare tale memoria dopo che la tabella non è più necessaria. Questo requisito include la memoria necessaria per la matrice STATIONQUERY usata in QUERYTABLE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h
DLL	Ndisnpp.dll; Rmtnpp.dll

Vedi anche

IESP

QUERYTABLE

STATIONQUERY