Função InternetAutodial (wininet.h)

  • Artigo

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 wininet.h (inclua Wininet.h)
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Estabelecer uma conexão discada com a Internet

Funções WinINet