Condividi tramite


Metodo IStats::QueryStations

Il metodo QueryStations fornisce un elenco di tutti i computer che attualmente acquisiscono i dati tramite Monitoraggio di rete.

Sintassi

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

Parametri

lpQueryTable [in, out]

Puntatore a una struttura QUERYTABLE . Nell'input, questa struttura deve contenere il numero massimo di computer che si desidera restituire da Monitoraggio di rete e una matrice di strutture STATIONQUERY .

Nell'output, questa struttura restituisce il numero di computer che acquisiscono dati e una struttura STATIONQUERY per ogni computer trovato. Si noti che queste informazioni possono 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 viene 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 la chiamata a CreateNPPInterface . Una chiamata a questo metodo è una chiamata sincrona, che può richiedere alcuni secondi perché 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

IStats

QUERYTABLE

STATIONQUERY