Funzione RasGetLinkStatistics (ras.h)

  • Articolo

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
E_INVALID_ARG
 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.
ERROR_NOT_ENOUGH_MEMORY
 La funzione non è stata in grado di allocare memoria sufficiente per completare l'operazione.
Altri
 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

Vedi anche

RasClearLinkStatistics

RasDial

RasEnumConnections

RasGetConnectionStatistics

Panoramica del servizio accesso remoto (RAS)

Funzioni del Servizio di accesso remoto