Método IStats::QueryStatus

El método QueryStatus recupera el estado del NPP.

Sintaxis

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

Parámetros

pNetworkStatus [out]

Puntero a una estructura NETWORKSTATUS devuelta que indica el estado actual (captura, pausado, detenido, etc.) del NPP. Es responsabilidad de la aplicación asignar y liberar la memoria para la estructura NETWORKSTATUS .

Valor devuelto

Si el método se ejecuta correctamente, el valor devuelto se NMERR_SUCCESS.

Si el método no se realiza correctamente, el valor devuelto es el código de error siguiente:

Código devuelto	Descripción
NMERR_INVALID_PARAMETER	El parámetro pNetworkStatus no apunta a una estructura NETWORKSTATUS válida. Asigne memoria para esta estructura y vuelva a llamar al método IStats::QueryStatus .

Comentarios

Este método se puede llamar en cualquier momento después de llamar al método CreateNPPInterface . Se puede llamar para ver si el NPP está conectado a la red, para averiguar el estado de la captura actual y para ver si hay algún desencadenador pendiente. Sin embargo, antes de llamar a este método, debe asignar la memoria necesaria para la estructura NETWORKSTATUS y liberar esa memoria cuando la estructura ya no sea necesaria.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Archivo DLL	Ndisnpp.dll; Rmtnpp.dll

Consulte también

IStats

CreateNPPInterface

NETWORKSTATUS