Share via


Função InternetAttemptConnect (wininet.h)

Tenta fazer uma conexão com a Internet.

Sintaxe

DWORD InternetAttemptConnect(
  [in] DWORD dwReserved
);

Parâmetros

[in] dwReserved

Esse parâmetro é reservado e deve ser 0.

Retornar valor

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro do sistema caso contrário.

Comentários

Essa função permite que um aplicativo primeiro tente se conectar antes de emitir solicitações. Um programa cliente pode usar isso para evocar a caixa de diálogo discada. Se a tentativa falhar, o aplicativo deverá entrar no modo offline.

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

Confira também

Habilitando a funcionalidade da Internet

Funções WinINet