Метод IStats::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

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

IStats

QUERYTABLE

STATIONQUERY