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

Метод IESP::QueryStations

  • Статья

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

Синтаксис

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

Параметры

lpQueryTable [in, out]

Указатель на структуру 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

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

IESP

QUERYTABLE

STATIONQUERY