Funzione InternetGetConnectedState (wininet.h)

Articolo
03/08/2023

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

Condividi tramite