RasGetLinkStatistics-Funktion (ras.h)
Die RasGetLinkStatistics-Funktion ruft kumulierte Statistiken für den angegebenen Link in einer RAS-Multilinkverbindung ab.
Syntax
DWORD RasGetLinkStatistics(
[in] HRASCONN hRasConn,
[in] DWORD dwSubEntry,
[in, out] RAS_STATS *lpStatistics
);
Parameter
[in] hRasConn
Handle mit der Verbindung. Verwenden Sie RasDial oder RasEnumConnections , um dieses Handle abzurufen.
[in] dwSubEntry
Gibt den Untereintrag an, der dem Link entspricht, für den Statistiken abgerufen werden sollen.
[in, out] lpStatistics
Zeiger auf die RAS_STATS Struktur, die bei der Ausgabe die Statistiken empfängt.
Bei der Eingabe gibt das dwSize-Element dieser Struktur die Größe von RAS_STATS an. Verwenden Sie sizeof(RAS_STATS), um diese Größe zu erhalten.
Dieser Parameter darf nicht NULL sein.
Rückgabewert
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 |
|---|---|
|
Mindestens eine der folgenden Punkte ist wahr: Der hRasConn-Parameter ist 0, der dwSubEntry-Parameter ist 0, 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. |
|
Die Funktion konnte nicht genügend Arbeitsspeicher zuweisen, um den Vorgang abzuschließen. |
|
Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht. |
Anforderungen
| 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 |