Función NetStatisticsGet (lmstats.h)

Artículo
03/13/2024

Recupera las estadísticas operativas de un servicio. Actualmente, solo se admiten los servicios de estación de trabajo y servidor.

Sintaxis

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

Parámetros

[in] ServerName

Puntero a una cadena que especifica el nombre DNS o NetBIOS del servidor en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.

[in] Service

Puntero a una cadena que especifica el nombre del servicio sobre el que se van a obtener las estadísticas. Actualmente solo se permiten los valores SERVICE_SERVER y SERVICE_WORKSTATION .

[in] Level

Especifica el nivel de información de los datos. Este parámetro puede ser el siguiente valor.

Valor	Significado
0	Devuelve estadísticas sobre una estación de trabajo o un servidor. El parámetro bufptr apunta a un STAT_WORKSTATION_0 o a una estructura de STAT_SERVER_0 .

[in] Options

Este parámetro debe ser cero.

[out] Buffer

Puntero al búfer que recibe los datos. El formato de estos datos depende del valor del parámetro level . El sistema asigna este búfer y se debe liberar mediante la función NetApiBufferFree . Para obtener más información, consulte Network Management Function Buffers (Búferes de funciones de administración de red) y Network Management Function Buffer Lengths (Longitudes de búfer de funciones de administración de red).

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

No se requiere ninguna pertenencia especial a grupos para obtener estadísticas de estación de trabajo. Solo los miembros del grupo local Administradores o Operadores de servidor pueden ejecutar correctamente la función NetStatisticsGet en un servidor remoto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmstats.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll