Funzione InternetDial (winineti.h)

Articolo
03/04/2024

Avvia una connessione a Internet utilizzando 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 remota da utilizzare. 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 una connessione Internet automatica. Se è necessario l'intervento dell'utente, la funzione avrà esito negativo.
INTERNET_DIAL_FORCE_PROMPT	Ignora l'impostazione "dial automatically" e forza la visualizzazione dell'interfaccia utente di composizione.
INTERNET_DIAL_UNATTENDED	Si connette 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 in caso di 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 remota.
ERROR_USER_DISCONNECTION	L'utente ha fatto clic sul pulsante Lavoro offline o Annulla nella finestra di dialogo Connessione Internet.

Commenti

InternetDial non supporta connessioni con chiamata doppia, autenticazione smart card 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 remota. 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 da DllMain o dai costruttori e distruttori di oggetti globali.

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).

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

Vedi anche

Stabilire una connessione remota a Internet

Funzioni WinINet

Condividi tramite