Função InternetAutodial (winineti.h)

Faz com que o modem disce automaticamente a conexão de Internet padrão.

Sintaxe

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

Parâmetros

[in] dwFlags

Controla essa operação. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
INTERNET_AUTODIAL_FAILIFSECURITYCHECK 0x04	Faz com que o InternetAutodial falhe se o compartilhamento de arquivos e impressoras estiver desabilitado para o Windows 95 ou posterior. Windows Server 2008 e Windows Vista: Esse sinalizador está obsoleto.
INTERNET_AUTODIAL_FORCE_ONLINE 0x01	Força uma conexão de Internet online.
INTERNET_AUTODIAL_FORCE_UNATTENDED 0x02	Força uma discagem autônoma da Internet.
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT 0x08	Faz com que o InternetAutodial disce a conexão de modem mesmo quando uma conexão de rede com a Internet está presente.

[in] hwndParent

Manipule para a janela pai.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Os aplicativos podem chamar GetLastError para recuperar o código de erro.

Comentários

O InternetAutodial não dá suporte a conexões de discagem dupla, autenticação SmartCard ou conexões que exigem certificação baseada em registro.

Nota A partir do Windows Vista e do Windows Server 2008, as funções de discagem WinINet usam as funções RAS para estabelecer uma conexão discada. O WinINet dá suporte à funcionalidade documentada na função RasDialDlg .

 

O InternetAutodial não tentará discar se houver uma conexão discada existente no sistema. Além disso, se houver uma conexão LAN existente e InternetAutodial não estiver configurado para forçar a discagem (defina o INTERNET_AUTODIAL_FORCE_ONLINE no parâmetro dwFlags ), o InternetAutodial não tentará discar a conexão e retornará TRUE.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

 

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winineti.h (inclua Wininet.h)
Biblioteca	Wininet.lib
DLL	Wininet.dll

Confira também

Estabelecer uma conexão discada com a Internet

Funções WinINet