Funzione RasGetLinkStatistics (ras.h)
La funzione RasGetLinkStatistics recupera le statistiche accumulate per il collegamento specificato in una connessione ras multilink.
Sintassi
DWORD RasGetLinkStatistics(
[in] HRASCONN hRasConn,
[in] DWORD dwSubEntry,
[in, out] RAS_STATS *lpStatistics
);
Parametri
[in] hRasConn
Handle per la connessione. Usare RasDial o RasEnumConnections per ottenere questo handle.
[in] dwSubEntry
Specifica la sottoentria che corrisponde al collegamento per il quale recuperare le statistiche.
[in, out] lpStatistics
Puntatore alla struttura RAS_STATS che, nell'output, riceve le statistiche.
Nell'input, il membro dwSize di questa struttura specifica le dimensioni di RAS_STATS. Usare sizeof(RAS_STATS) per ottenere questa dimensione.
Questo parametro non può essere NULL.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Routing e Remote Access Error Codes o Winerror.h.
| Valore | Significato |
|---|---|
|
Almeno uno dei valori seguenti è true: il parametro hRasConn è zero, il parametro dwSubEntry è zero, il parametro lpStatistics è NULL o il valore specificato dal membro dwSize della struttura RAS_STATS specifica una versione della struttura non supportata dal sistema operativo in uso. |
|
La funzione non è stata in grado di allocare memoria sufficiente per completare l'operazione. |
|
Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ras.h |
| Libreria | Rasapi32.lib |
| DLL | Rasapi32.dll |