Método IDelaydC::QueryStations
O método QueryStations fornece uma lista de todos os computadores que estão atualmente usando o Monitor de Rede para capturar dados.
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 essa lista 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 |
|---|---|
|
Nenhuma memória estava disponível para processar essa consulta. |
Comentários
Esse método pode ser chamado a qualquer momento após CreateNPPInterface ser chamado. Uma chamada para esse método é uma chamada síncrona, que pode levar vários segundos para ser concluída enquanto o Monitor de Rede aguarda que 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 |
|
| DLL |
|