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 WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).
 

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

Vedi anche

Abilitazione della funzionalità Internet

Funzioni WinINet