Método IRTC::QueryStations
O método QueryStations fornece uma lista de todos os computadores atualmente usando o Monitor de Rede para capturar dados de rede.
Sintaxe
HRESULT STDMETHODCALLTYPE QueryStations(
[in, out] QUERYTABLE *lpQueryTable
);
Parâmetros
-
lpQueryTable [in, out]
-
Um 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 capturam dados e uma estrutura STATIONQUERY para cada computador encontrado. Lembre-se de que isso 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á um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
|
A memória necessária para processar essa consulta não está disponível. |
Comentários
Esse método pode ser chamado a qualquer momento depois que o método CreateNPPInterface for 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.
O usuário deve 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 |
|