RasGetConnectionStatistics-Funktion (ras.h)

Die RasGetConnectionStatistics-Funktion ruft akkumulierte Verbindungsstatistiken für die angegebene Verbindung ab.

Syntax

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

[in] hRasConn

Handle für die Verbindung. Verwenden Sie RasDial oder RasEnumConnections , um dieses Handle abzurufen.

[in, out] lpStatistics

Zeiger auf die RAS_STATS Struktur, die bei der Ausgabe die Statistiken empfängt.

Legen Sie bei der Eingabe den dwSize-Member dieser Struktur auf sizeof(RAS_STATS) fest.

Dieser Parameter darf nicht NULL sein.

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und RAS-Fehlercodes oder Winerror.h.

Wert	Bedeutung
E_INVALIDARG	Mindestens eine der folgenden Werte ist wahr: Der hRasConn-Parameter ist null, der lpStatistics-Parameter ist NULL, oder der vom dwSize-Member der RAS_STATS -Struktur angegebene Wert gibt eine Version der Struktur an, die vom verwendeten Betriebssystem nicht unterstützt wird.
ERROR_NOT_ENOUGH_MEMORY	Die Funktion konnte nicht genügend Arbeitsspeicher zuweisen, um den Vorgang abzuschließen.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ras.h
Bibliothek	Rasapi32.lib
DLL	Rasapi32.dll