Metodo IStats::QueryStatus

Il metodo QueryStatus recupera lo stato del gruppo di sicurezza di rete.

Sintassi

HRESULT STDMETHODCALLTYPE QueryStatus(
  [out] NETWORKSTATUS *pNetworkStatus
);

Parametri

pNetworkStatus [out]

Puntatore a una struttura NETWORKSTATUS restituita che indica lo stato corrente (acquisizione, sospensione, arresto e così via) del gruppo di sicurezza di rete. È responsabilità dell'applicazione allocare e liberare la memoria per la struttura NETWORKSTATUS .

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_INVALID_PARAMETER	Il parametro pNetworkStatus non punta a una struttura NETWORKSTATUS valida. Allocare la memoria per questa struttura e chiamare di nuovo il metodo IStats::QueryStatus .

Commenti

Questo metodo può essere chiamato in qualsiasi momento dopo che viene chiamato il metodo CreateNPPInterface . Può essere chiamato per verificare se il gruppo di sicurezza di rete è connesso alla rete, per scoprire lo stato dell'acquisizione corrente e per verificare se i trigger sono in sospeso. Prima di chiamare questo metodo, tuttavia, è necessario allocare la memoria necessaria per la struttura NETWORKSTATUS e liberare tale memoria quando la struttura non è più necessaria.

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

CreateNPPInterface

NETWORKSTATUS