Funzione InternetCheckConnectionA (wininet.h)

Articolo
11/20/2024

[ InternetCheckConnection è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. 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 un nullstringa con terminazione 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 non è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 viene stabilita correttamente una connessione oppure 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.

Osservazioni

InternetCheckConnection è deprecato. InternetCheckConnection non funziona in ambienti che usano un server proxy Web per accedere a Internet. A seconda dell'ambiente, usare 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 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wininet.h
libreria	Wininet.lib
dll	Wininet.dll

Vedere anche

Abilitazione della funzionalità Internet

funzioni WinINet

Condividi tramite