Função InternetDialA (wininet.h)

  • Artigo

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

Sintaxe

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

Parâmetros

[in] hwndParent

Manipule 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 de outra forma. 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 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 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).
 

Observação

O cabeçalho wininet.h define InternetDial como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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 (incluem Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Estabelecer uma conexão discada com a Internet

Funções WinINet