Функция NetStatisticsGet (lmstats.h)

Статья
08/24/2023

Извлекает операционную статистику для службы. В настоящее время поддерживаются только службы рабочей станции и сервера.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetStatisticsGet(
  [in]  LPTSTR ServerName,
  [in]  LPTSTR Service,
  [in]  DWORD  Level,
  [in]  DWORD  Options,
  [out] LPBYTE *Buffer
);

Параметры

[in] ServerName

Указатель на строку, указывающую DNS или NetBIOS-имя сервера, на котором выполняется функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

[in] Service

Указатель на строку, указывающую имя службы, о которой нужно получить статистику. В настоящее время разрешены только значения SERVICE_SERVER и SERVICE_WORKSTATION .

[in] Level

Задает уровень информации данных. Этот параметр может иметь следующее значение.

Значение	Значение
0	Возвращает статистику о рабочей станции или сервере. Параметр bufptr указывает на структуру STAT_WORKSTATION_0 или STAT_SERVER_0 .

[in] Options

Этот параметр должен быть равен нулю.

[out] Buffer

Указатель на буфер, который получает данные. Формат этих данных зависит от значения параметра level . Этот буфер выделяется системой и должен быть освобожден с помощью функции NetApiBufferFree . Дополнительные сведения см. в разделах Буферы функций управления сетью и Длина буфера функции управления сетью.

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

Если функция выполнена успешно, возвращаемое значение будет NERR_Success.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки. Список кодов ошибок см. в разделе Системные коды ошибок.

Для получения статистики рабочей станции не требуется специальное членство в группах. Только члены локальной группы Администраторы или Операторы сервера могут успешно выполнять функцию NetStatisticsGet на удаленном сервере.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	lmstats.h (включая Lm.h)
Библиотека	Netapi32.lib
DLL	Netapi32.dll