RasGetLinkStatistics, fonction (ras.h)

La fonction RasGetLinkStatistics récupère les statistiques accumulées pour le lien spécifié dans une connexion multilink RAS.

Syntaxe

DWORD RasGetLinkStatistics(
  [in]      HRASCONN  hRasConn,
  [in]      DWORD     dwSubEntry,
  [in, out] RAS_STATS *lpStatistics
);

[in] hRasConn

Handle à la connexion. Utilisez RasDial ou RasEnumConnections pour obtenir ce handle.

[in] dwSubEntry

Spécifie la sous-entrée qui correspond au lien pour lequel récupérer les statistiques.

[in, out] lpStatistics

Pointeur vers la structure RAS_STATS qui, à la sortie, reçoit les statistiques.

Lors de l’entrée, le membre dwSize de cette structure spécifie la taille de RAS_STATS. Utilisez sizeof(RAS_STATS) pour obtenir cette taille.

Ce paramètre ne peut pas être NULL.

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

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants ou une valeur provenant des codes d’erreur de routage et d’accès à distance ou winerror.h.

Valeur	Signification
E_INVALID_ARG	Au moins l’une des valeurs suivantes est vraie : le paramètre hRasConn est égal à zéro, le paramètre dwSubEntry est égal à zéro, le paramètre lpStatistics est NULL ou la valeur spécifiée par le membre dwSize de la structure RAS_STATS spécifie une version de la structure qui n’est pas prise en charge par le système d’exploitation utilisé.
ERROR_NOT_ENOUGH_MEMORY	La fonction n’a pas pu allouer suffisamment de mémoire pour terminer l’opération.
Autres	Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ras.h
Bibliothèque	Rasapi32.lib
DLL	Rasapi32.dll