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