Funzione InternetDialW (wininet.h)

Articolo
11/20/2024

Avvia una connessione a Internet utilizzando un modem.

Sintassi

DWORD InternetDialW(
  [in]  HWND      hwndParent,
  [in]  LPWSTR    lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

Parametri

[in] hwndParent

Handle nella finestra padre.

[in] lpszConnectoid

Puntatore a un nullstringa con terminazione 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ò essere 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 Work Offline o Annulla nella finestra di dialogo Connessione Internet.

Osservazioni

InternetDial non supporta connessioni con doppia connessione, 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 dall'interno di 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 Servizi HTTP Di Microsoft Windows (WinHTTP).

Nota

L'intestazione wininet.h definisce InternetDial 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 (include Wininet.h, Winineti.h, Wininet.h, Winineti.h)
libreria	Wininet.lib
dll	Wininet.dll

Vedere anche

stabilire una connessione remota a Internet

funzioni WinINet

Condividi tramite