Funzione InternetCheckConnectionA (wininet.h)
[InternetCheckConnection è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece NetworkInformation.GetInternetConnectionProfile o le interfacce NLM. ]
Consente a un'applicazione di verificare se è possibile stabilire una connessione a Internet.
Sintassi
BOOL InternetCheckConnectionA(
[in] LPCSTR lpszUrl,
[in] DWORD dwFlags,
[in] DWORD dwReserved
);
Parametri
[in] lpszUrl
Puntatore a una stringa con terminazione Null che specifica l'URL da usare per controllare la connessione. Questo valore può essere NULL.
[in] dwFlags
Opzioni. FLAG_ICC_FORCE_CONNECTION è l'unico flag attualmente disponibile. Se questo flag è impostato, forza una connessione. Viene tentata una connessione socket nell'ordine seguente:
- Se lpszUrl è diverso da NULL, il valore host viene estratto da esso e usato per effettuare il ping di tale host specifico.
- Se lpszUrl è NULL ed è presente una voce nel database del server interno per il server più vicino, il valore host viene estratto dalla voce e usato per effettuare il ping di tale server.
[in] dwReserved
Questo parametro è riservato e deve essere 0.
Valore restituito
Restituisce TRUE se una connessione viene stabilita correttamente o FALSE in caso contrario. Usare GetLastError per recuperare il codice di errore. ERROR_NOT_CONNECTED viene restituito da GetLastError se non è possibile stabilire una connessione o se il database dei socket è offline in modo incondizionato.
Commenti
InternetCheckConnection è deprecato. InternetCheckConnection non funziona in ambienti che usano un server proxy Web per accedere a Internet. A seconda dell'ambiente, usare invece NetworkInformation.GetInternetConnectionProfile o le interfacce NLM per verificare l'accesso a Internet.
Nota
L'intestazione wininet.h definisce InternetCheckConnection come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| 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 |
| Libreria | Wininet.lib |
| DLL | Wininet.dll |