Função InternetDial (winineti.h)

  • Artigo

Inicia uma conexão com a Internet usando um modem.

Sintaxe

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

Parâmetros

[in] hwndParent

Identificador para a janela pai.

[in] lpszConnectoid

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da conexão discada a ser usada. Se esse parâmetro contiver a cadeia de caracteres vazia (""), o usuário escolherá a conexão. Se esse parâmetro for NULL, a função se conectará à conexão autodial.

[in] dwFlags

Opções. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
INTERNET_AUTODIAL_FORCE_ONLINE
 Força uma conexão online.
INTERNET_AUTODIAL_FORCE_UNATTENDED
 Força uma discagem autônoma da Internet. Se a intervenção do usuário for necessária, a função falhará.
INTERNET_DIAL_FORCE_PROMPT
 Ignora a configuração "discar automaticamente" e força a interface do usuário de discagem a ser exibida.
INTERNET_DIAL_UNATTENDED
 Conecta-se à Internet por meio de um modem, sem exibir uma interface do usuário, se possível. Caso contrário, a função aguardará a entrada do usuário.
INTERNET_DIAL_SHOW_OFFLINE
 Mostra o botão Trabalhar Offline em vez do botão Cancelar na interface do usuário de discagem.

[out] lpdwConnection

Ponteiro para uma variável que especifica o número da conexão. Esse número é um identificador exclusivo para a conexão que pode ser usada em outras funções, como InternetHangUp.

[in] dwReserved

Esse parâmetro é reservado e deve ser NULL.

Retornar valor

Retorna ERROR_SUCCESS se tiver êxito ou um valor de erro caso contrário. O código de erro pode ser um dos valores a seguir.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros estão incorretos.
ERROR_NO_CONNECTION
 Há um problema com a conexão discada.
ERROR_USER_DISCONNECTION
 O usuário clicou no botão Trabalhar Offline ou Cancelar na caixa de diálogo Conexão com a Internet.

Comentários

O InternetDial 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 do WinINet usam as funções RAS para estabelecer uma conexão discada. O WinINet dá suporte à funcionalidade documentada na função RasDialDlg .
 
Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de 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 de servidor ou serviços, 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 (incluem Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Estabelecendo uma conexão discada com a Internet

Funções WinINet