Compartilhar via

Método IESP::QueryStatus

  • Artigo

O método QueryStatus recupera o status do NPP.

Sintaxe

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

Parâmetros

pNetworkStatus [out]

Um ponteiro para uma estrutura NETWORKSTATUS retornada que indica o estado atual (capturando, pausado, parado e assim por diante) do NPP. O usuário deve alocar e liberar a memória para a estrutura NETWORKSTATUS.

Valor retornado

Se o método for bem-sucedido, o valor retornado será NMERR_SUCCESS.

Se o método não for bem-sucedido, o valor retornado será o seguinte código de erro:

Código de retorno Descrição
NMERR_INVALID_PARAMETER
 O parâmetro pNetworkStatus não está apontando para uma estrutura NETWORKSTATUS válida. Aloque memória para essa estrutura e chame IESP::QueryStatus novamente.

Comentários

Esse método pode ser chamado a qualquer momento depois que CreateNPPInterface for chamado. Você pode chamar esse método para ver se o NPP está conectado à rede, para descobrir o status da captura atual e para ver se algum gatilho está pendente.

Antes de chamar esse método, aloque a memória necessária para a estrutura NETWORKSTATUS e libere essa memória quando a estrutura não for mais necessária.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

Confira também

IESP

CreateNPPInterface

NETWORKSTATUS