Partager via


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
);

Paramètres

[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.

Valeur retournée

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

Configuration requise

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

Voir aussi

RasClearConnectionStatistics

RasDial

RasEnumConnections

RasGetLinkStatistics

Vue d’ensemble du service d’accès à distance (RAS)

Fonctions du service d’accès à distance