NetStatisticsGet, fonction (lmstats.h)

Article
02/28/2024

Récupère les statistiques d’exploitation d’un service. Actuellement, seuls les services de station de travail et de serveur sont pris en charge.

Syntaxe

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

Paramètres

[in] ServerName

Pointeur vers une chaîne qui spécifie le nom DNS ou NetBIOS du serveur sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] Service

Pointeur vers une chaîne qui spécifie le nom du service sur lequel obtenir les statistiques. Seules les valeurs SERVICE_SERVER et SERVICE_WORKSTATION sont actuellement autorisées.

[in] Level

Spécifie le niveau d’informations des données. Ce paramètre peut être la valeur suivante.

Valeur	Signification
0	Retourne des statistiques sur une station de travail ou un serveur. Le paramètre bufptr pointe vers un STAT_WORKSTATION_0 ou une structure STAT_SERVER_0 .

[in] Options

Ce paramètre doit être égal à zéro.

[out] Buffer

Pointeur vers la mémoire tampon qui reçoit les données. Le format de ces données dépend de la valeur du paramètre level . Cette mémoire tampon est allouée par le système et doit être libérée à l’aide de la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.

Remarques

Aucune appartenance à un groupe spécial n’est requise pour obtenir des statistiques de station de travail. Seuls les membres du groupe local Administrateurs ou Opérateurs de serveur peuvent exécuter correctement la fonction NetStatisticsGet sur un serveur distant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmstats.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll