Метод IRTC::QueryStations
Метод QueryStations предоставляет список всех компьютеров, использующих монитор сети для сбора сетевых данных.
Синтаксис
HRESULT STDMETHODCALLTYPE QueryStations(
[in, out] QUERYTABLE *lpQueryTable
);
Параметры
-
lpQueryTable [вход, выход]
-
Указатель на структуру QUERYTABLE . При входе эта структура должна содержать максимальное количество компьютеров, которые требуется вернуть монитору сети, и массив структур STATIONQUERY .
В выходных данных эта структура возвращает количество компьютеров, записывющих данные, и структуру STATIONQUERY для каждого найденного компьютера. Помните, что это могут быть компьютеры, использующие версии сетевого монитора, предшествующие версии 2.0.
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет NMERR_SUCCESS.
Если метод не выполнен, возвращаемое значение представляет собой один из следующих кодов ошибок:
Код возврата | Описание |
---|---|
|
Память, необходимая для обработки этого запроса, недоступна. |
Комментарии
Этот метод можно вызвать в любое время после вызова метода CreateNPPInterface . Вызов этого метода является синхронным вызовом, который может занять несколько секунд, пока сетевой монитор ожидает ответа удаленных компьютеров на запрос. Можно запрашивать только компьютеры в локальной подсети.
Пользователь должен выделить память для структуры QUERYTABLE и освободить ее после того, как таблица больше не требуется. Это требование включает память, необходимую для массива STATIONQUERY, используемого в QUERYTABLE.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
Заголовок |
|
DLL |
|