NetStatisticsGet function (lmstats.h)

Retrieves operating statistics for a service. Currently, only the workstation and server services are supported.


  [in]  LPTSTR ServerName,
  [in]  LPTSTR Service,
  [in]  DWORD  Level,
  [in]  DWORD  Options,
  [out] LPBYTE *Buffer


[in] ServerName

Pointer to a string that specifies the DNS or NetBIOS name of the server on which the function is to execute. If this parameter is NULL, the local computer is used.

[in] Service

Pointer to a string that specifies the name of the service about which to get the statistics. Only the values SERVICE_SERVER and SERVICE_WORKSTATION are currently allowed.

[in] Level

Specifies the information level of the data. This parameter can be the following value.

Value Meaning
Return statistics about a workstation or a server. The bufptr parameter points to a STAT_WORKSTATION_0 or a STAT_SERVER_0 structure.

[in] Options

This parameter must be zero.

[out] Buffer

Pointer to the buffer that receives the data. The format of this data depends on the value of the level parameter. This buffer is allocated by the system and must be freed using the NetApiBufferFree function. For more information, see Network Management Function Buffers and Network Management Function Buffer Lengths.

Return value

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a system error code. For a list of error codes, see System Error Codes.


No special group membership is required to obtain workstation statistics. Only members of the Administrators or Server Operators local group can successfully execute the NetStatisticsGet function on a remote server.


Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header lmstats.h (include Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

See also


Network Management Functions

Network Management Overview



Statistics Functions