Поделиться через


Метод IRTC::QueryStations

Метод QueryStations предоставляет список всех компьютеров, использующих монитор сети для сбора сетевых данных.

Синтаксис

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

Параметры

lpQueryTable [вход, выход]

Указатель на структуру QUERYTABLE . При входе эта структура должна содержать максимальное количество компьютеров, которые требуется вернуть монитору сети, и массив структур STATIONQUERY .

В выходных данных эта структура возвращает количество компьютеров, записывющих данные, и структуру STATIONQUERY для каждого найденного компьютера. Помните, что это могут быть компьютеры, использующие версии сетевого монитора, предшествующие версии 2.0.

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет NMERR_SUCCESS.

Если метод не выполнен, возвращаемое значение представляет собой один из следующих кодов ошибок:

Код возврата Описание
NMERR_OUT_OF_MEMORY
Память, необходимая для обработки этого запроса, недоступна.

Комментарии

Этот метод можно вызвать в любое время после вызова метода CreateNPPInterface . Вызов этого метода является синхронным вызовом, который может занять несколько секунд, пока сетевой монитор ожидает ответа удаленных компьютеров на запрос. Можно запрашивать только компьютеры в локальной подсети.

Пользователь должен выделить память для структуры QUERYTABLE и освободить ее после того, как таблица больше не требуется. Это требование включает память, необходимую для массива STATIONQUERY, используемого в QUERYTABLE.

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

См. также раздел

IRTC

QUERYTABLE

STATIONQUERY