Fonction RasGetConnectionStatistics (ras.h)

La fonction RasGetConnectionStatistics récupère les statistiques de connexion accumulées pour la connexion spécifiée.

Syntaxe

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

[in] hRasConn

Gérer la connexion. Utilisez RasDial ou RasEnumConnections pour obtenir ce handle.

[in, out] lpStatistics

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

Lors de l’entrée, définissez le membre dwSize de cette structure sur sizeof(RAS_STATS).

Ce paramètre ne peut pas avoir la valeur 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 de Winerror.h.

Valeur	Signification
E_INVALIDARG	Au moins l’une des valeurs suivantes est vraie : le paramètre hRasConn est égal à zéro, le paramètre lpStatistics a la valeur 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