Funzione InternetGetConnectedState (wininet.h)

  • Articolo
Nota L'uso di questa API non è consigliato, usare invece il metodo INetworkListManager::GetConnectivity .
 
Recupera lo stato connesso del sistema locale.

Sintassi

BOOL InternetGetConnectedState(
  [out] LPDWORD lpdwFlags,
  [in]  DWORD   dwReserved
);

Parametri

[out] lpdwFlags

Puntatore a una variabile che riceve la descrizione della connessione. Questo parametro può restituire un flag valido anche quando la funzione restituisce FALSE. Questo parametro può essere uno o più dei valori seguenti.

Valore Significato
INTERNET_CONNECTION_CONFIGURED
0x40
 Il sistema locale ha una connessione valida a Internet, ma potrebbe o non essere attualmente connesso.
INTERNET_CONNECTION_LAN
0x02
 Il sistema locale usa una rete locale per connettersi a Internet.
INTERNET_CONNECTION_MODEM
0x01
 Il sistema locale usa un modem per connettersi a Internet.
INTERNET_CONNECTION_MODEM_BUSY
0x08
 Non più utilizzata.
INTERNET_CONNECTION_OFFLINE
0x20
 Il sistema locale è in modalità offline.
INTERNET_CONNECTION_PROXY
0x04
 Il sistema locale usa un server proxy per connettersi a Internet.
INTERNET_RAS_INSTALLED
0x10
 Il sistema locale è installato.

[in] dwReserved

Questo parametro è riservato e deve essere 0.

Valore restituito

Restituisce TRUE se è presente un modem attivo o una connessione Internet LAN o FALSE se non è presente alcuna connessione Internet o se tutte le connessioni Internet possibili non sono attualmente attive. Per altre informazioni, vedere la sezione Osservazioni.

Quando InternetGetConnectedState restituisce FALSE, l'applicazione può chiamare GetLastError per recuperare il codice di errore.

Commenti

Un valore restituito di TRUE da InternetGetConnectedState indica che è disponibile almeno una connessione a Internet. Non garantisce che sia possibile stabilire una connessione a un host specifico. Le applicazioni devono sempre controllare gli errori restituiti dalle chiamate API che si connettono a un server. InternetCheckConnection può essere chiamato per determinare se è possibile stabilire una connessione a una destinazione specifica.

Un valore restituito di TRUE indica che la connessione modem è attiva o una connessione LAN è attiva e un proxy è configurato correttamente per la LAN. Un valore restituito di FALSE indica che non è connesso né il modem né la LAN. Se viene restituito FALSE, il flag INTERNET_CONNECTION_CONFIGURED può essere impostato per indicare che l'autenticazione automatica è configurata su "always dial" ma non è attualmente attiva. Se l'autenticazione automatica non è configurata, la funzione restituisce FALSE.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro dall'interno di DllMain o dai costruttori e distruttori degli oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni o i servizi server usano Microsoft Windows HTTP Services (WinHTTP).
 

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 wininet.h (include Wininet.h)
Libreria Wininet.lib
DLL Wininet.dll

Vedi anche

Definizione di una connessione con accesso esterno a Internet

Funzioni WinINet