Método IESP::QueryStations

O método QueryStations fornece uma lista de todos os computadores que atualmente usam o Monitor de Rede para capturar dados de rede.

Sintaxe

HRESULT STDMETHODCALLTYPE QueryStations(
  [in, out] QUERYTABLE *lpQueryTable
);

Parâmetros

lpQueryTable [in, out]

Ponteiro para uma estrutura QUERYTABLE . Na entrada, essa estrutura deve conter o número máximo de computadores que você deseja que o Monitor de Rede retorne e uma matriz de estruturas STATIONQUERY .

Na saída, essa estrutura retorna o número de computadores que estão capturando dados e uma estrutura STATIONQUERY para cada computador encontrado. Observe que esse total pode incluir computadores que usam versões do Monitor de Rede que antecedem a versão 2.0.

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_OUT_OF_MEMORY	A memória necessária para processar essa consulta não estava disponível.

Comentários

Esse método pode ser chamado a qualquer momento depois que o método CreateNPPInterface é chamado. Uma chamada para esse método é uma chamada síncrona, que pode levar vários segundos para ser concluída à medida que o Monitor de Rede aguarda que os computadores remotos respondam à consulta. Somente computadores na sub-rede local podem ser consultados.

É sua responsabilidade alocar a memória para a estrutura QUERYTABLE e liberar essa memória depois que a tabela não for mais necessária. Esse requisito inclui a memória necessária para a matriz STATIONQUERY usada em QUERYTABLE.

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

QUERYTABLE

STATIONQUERY