Partager via


NetStatisticsGet, fonction (lmstats.h)

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 gestionré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

Voir aussi

NetServerGetInfo

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

STAT_SERVER_0

STAT_WORKSTATION_0

Fonctions statistiques