Método IStats::QueryStatus
O método QueryStatus recupera o status do NPP.
Sintaxe
HRESULT STDMETHODCALLTYPE QueryStatus(
[out] NETWORKSTATUS *pNetworkStatus
);
Parâmetros
-
pNetworkStatus [out]
-
Ponteiro para uma estrutura NETWORKSTATUS retornada que indica o estado atual (capturando, pausado, parado e assim por diante) do NPP. É responsabilidade do aplicativo 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 |
|---|---|
|
O parâmetro pNetworkStatus não está apontando para uma estrutura NETWORKSTATUS válida. Aloque memória para essa estrutura e chame o método IStats::QueryStatus novamente. |
Comentários
Esse método pode ser chamado a qualquer momento depois que o método CreateNPPInterface for chamado. Ele pode ser chamado para ver se o NPP está conectado à rede, para descobrir o status da captura atual e para ver se algum gatilho está pendente. No entanto, antes de chamar esse método, você deve alocar a memória necessária para a estrutura NETWORKSTATUS e liberar 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 |
|
| DLL |
|