Funzione InternetDial (wininet.h)

Articolo
03/08/2023

Avvia una connessione a Internet usando un modem.

Sintassi

DWORD InternetDial(
  [in]  HWND    hwndParent,
  [in]  LPSTR   lpszConnectoid,
  [in]  DWORD   dwFlags,
  [out] LPDWORD lpdwConnection,
  [in]  DWORD   dwReserved
);

Parametri

[in] hwndParent

Handle per la finestra padre.

[in] lpszConnectoid

Puntatore a una stringa con terminazione null che specifica il nome della connessione con accesso esterno da usare. Se questo parametro contiene la stringa vuota (""), l'utente sceglie la connessione. Se questo parametro è NULL, la funzione si connette alla connessione automatica.

[in] dwFlags

Opzioni. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
INTERNET_AUTODIAL_FORCE_ONLINE	Forza una connessione online.
INTERNET_AUTODIAL_FORCE_UNATTENDED	Forza un accesso esterno a Internet automatico. Se è necessario un intervento dell'utente, la funzione avrà esito negativo.
INTERNET_DIAL_FORCE_PROMPT	Ignora l'impostazione "dial automaticamente" e forza la visualizzazione dell'interfaccia utente di composizione.
INTERNET_DIAL_UNATTENDED	Connettersi a Internet tramite un modem, senza visualizzare un'interfaccia utente, se possibile. In caso contrario, la funzione attenderà l'input dell'utente.
INTERNET_DIAL_SHOW_OFFLINE	Mostra il pulsante Work Offline anziché il pulsante Annulla nell'interfaccia utente di composizione.

[out] lpdwConnection

Puntatore a una variabile che specifica il numero di connessione. Questo numero è un identificatore univoco per la connessione che può essere usata in altre funzioni, ad esempio InternetHangUp.

[in] dwReserved

Questo parametro è riservato e deve essere NULL.

Valore restituito

Restituisce ERROR_SUCCESS se ha esito positivo o un valore di errore in caso contrario. Il codice di errore può essere uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno o più parametri non sono corretti.
ERROR_NO_CONNECTION	Si è verificato un problema con la connessione con accesso esterno.
ERROR_USER_DISCONNECTION	L'utente ha fatto clic sul pulsante Work Offline o Annulla nella finestra di dialogo Connessione Internet.

Commenti

InternetDial non supporta connessioni con doppia connessione, 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 .

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


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, Winineti.h, Wininet.h, Winineti.h)
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

Definizione di una connessione con accesso esterno a Internet

Funzioni WinINet

Condividi tramite