Função InternetDialA (winineti.h)

Artigo
11/20/2024

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 um cadeia de caracteres nulaterminada 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 de correção automática.

[in] dwFlags

Opções. Esse parâmetro pode ser 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 Offline do 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.

Valor de retorno

Retorna ERROR_SUCCESS se tiver êxito ou um valor de erro de outra forma. O código de erro pode ser um dos seguintes valores.

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 offline ou botão Cancelar na caixa de diálogo conexão com a Internet.

Observações

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

Observação 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.

Assim 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.

Observaçã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 do Microsoft Windows HTTP Services (WinHTTP).

Nota

O cabeçalho winineti.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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winineti.h (incluem Wininet.h, Winineti.h, Wininet.h, Winineti.h)
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

estabelecer uma conexão discada com o da Internet

Funções WinINet

Compartilhar via