Funzione InternetAutodial (wininet.h)

Articolo
03/04/2024

Causa la chiamata automatica del modem alla connessione Internet predefinita.

Sintassi

BOOL InternetAutodial(
  [in] DWORD dwFlags,
  [in] HWND  hwndParent
);

Parametri

[in] dwFlags

Controlla questa operazione. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
INTERNET_AUTODIAL_FAILIFSECURITYCHECK 0x04	Causa l'esito negativo di InternetAutodial se la condivisione file e stampante è disabilitata per Windows 95 o versioni successive. Windows Server 2008 e Windows Vista: Questo flag è obsoleto.
INTERNET_AUTODIAL_FORCE_ONLINE 0x01	Forza una connessione Internet online.
INTERNET_AUTODIAL_FORCE_UNATTENDED 0x02	Forza un accesso esterno a Internet automatico.
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT 0x08	Causa la chiamata a InternetAutodial anche quando è presente una connessione di rete a Internet.

[in] hwndParent

Handle per la finestra padre.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Le applicazioni possono chiamare GetLastError per recuperare il codice di errore.

Commenti

InternetAutodial non supporta connessioni con doppio accesso, autenticazione SmartCard o connessioni che richiedono la certificazione basata sul Registro di sistema.

Nota A partire da Windows Vista e Windows Server 2008, le funzioni di connessione remota WinINet usano le funzioni RAS per stabilire una connessione con accesso esterno. WinINet supporta la funzionalità documentata nella funzione RasDialDlg .

InternetAutodial non tenta di comporre se è presente una connessione con accesso esterno esistente nel sistema. Inoltre, se esiste una connessione LAN esistente e InternetAutodial non è configurato per forzare il dial (impostare il INTERNET_AUTODIAL_FORCE_ONLINE nel parametro dwFlags ), InternetAutodial non tenta di comporre la connessione e restituisce TRUE.

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