NetStatisticsGet 函数 (lmstats.h)

项目
03/04/2024

检索服务的运行统计信息。目前，仅支持工作站和服务器服务。

语法

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

指向接收数据的缓冲区的指针。此数据的格式取决于级别参数的值。此缓冲区由系统分配，必须使用 NetApiBufferFree 函数释放。有关详细信息，请参阅网络管理功能缓冲区和网络管理功能缓冲区长度。

返回值

如果函数成功，则返回值 NERR_Success。

如果函数失败，则返回值为系统错误代码。有关错误代码的列表，请参阅系统错误代码。

注解

无需特殊的组成员身份即可获取工作站统计信息。只有管理员或服务器操作员本地组的成员才能在远程服务器上成功执行 NetStatisticsGet 函数。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	lmstats.h (包括 Lm.h)
Library	Netapi32.lib
DLL	Netapi32.dll