Função InternetOpenA (wininet.h)

Inicializa o uso de um aplicativo das funções WinINet.

Sintaxe

HINTERNET InternetOpenA(
  [in] LPCSTR lpszAgent,
  [in] DWORD  dwAccessType,
  [in] LPCSTR lpszProxy,
  [in] LPCSTR lpszProxyBypass,
  [in] DWORD  dwFlags
);

Parâmetros

[in] lpszAgent

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do aplicativo ou da entidade que chama as funções WinINet. Esse nome é usado como o agente de usuário no protocolo HTTP.

[in] dwAccessType

Tipo de acesso necessário. Esse parâmetro pode usar um dos valores a seguir.

[in] lpszProxy

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome dos servidores proxy a serem usados quando o acesso de proxy for especificado definindo dwAccessType como INTERNET_OPEN_TYPE_PROXY. Não use uma cadeia de caracteres vazia, pois InternetOpen a usará como o nome do proxy. As funções WinINet reconhecem apenas proxies de tipo CERN (somente HTTP) e o gateway FTP do TIS (somente FTP). Se o Microsoft Internet Explorer estiver instalado, essas funções também darão suporte a proxies SOCKS. As solicitações FTP podem ser feitas por meio de um proxy de tipo CERN alterando-as para uma solicitação HTTP ou usando InternetOpenUrl. Se dwAccessType não estiver definido como INTERNET_OPEN_TYPE_PROXY, esse parâmetro será ignorado e deverá ser NULL. Para obter mais informações sobre como listar servidores proxy, consulte a seção Listagem de Servidores Proxy de Habilitação da Funcionalidade da Internet.

[in] lpszProxyBypass

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica uma lista opcional de nomes de host ou endereços IP, ou ambos, que não devem ser roteados por meio do proxy quando dwAccessType é definido como INTERNET_OPEN_TYPE_PROXY. A lista pode conter curingas. Não use uma cadeia de caracteres vazia, pois o InternetOpen a usará como a lista de bypass de proxy. Se esse parâmetro especificar a macro "<local>", a função ignorará o proxy para qualquer nome de host que não contenha um período.

Por padrão, o WinINet ignorará o proxy para solicitações que usam os nomes de host "localhost", "loopback", "127.0.0.1" ou "[::1]". Esse comportamento existe porque um servidor proxy remoto normalmente não resolve esses endereços corretamente.Internet Explorer 9: você pode remover o computador local da lista de bypass de proxy usando a macro "<-loopback>".

Se dwAccessType não estiver definido como INTERNET_OPEN_TYPE_PROXY, esse parâmetro será ignorado e deverá ser NULL.

[in] dwFlags

Opções. Esse parâmetro pode ser uma combinação dos seguintes valores.

Retornar valor

Retorna um identificador válido que o aplicativo passa para funções WinINet subsequentes. Se InternetOpen falhar, ele retornará NULL. Para recuperar uma mensagem de erro específica, chame GetLastError.

Comentários

InternetOpen é a primeira função WinINet chamada por um aplicativo. Ele informa à DLL da Internet para inicializar estruturas de dados internas e se preparar para chamadas futuras do aplicativo. Quando o aplicativo terminar de usar as funções da Internet, ele deverá chamar InternetCloseHandle para liberar o identificador e todos os recursos associados.

O aplicativo pode fazer qualquer número de chamadas para InternetOpen, embora uma única chamada normalmente seja suficiente. O aplicativo pode precisar definir comportamentos separados para cada instância internetOpen , como servidores proxy diferentes configurados para cada uma.

Depois que o aplicativo de chamada terminar de usar o identificador HINTERNET retornado pelo InternetOpen, ele deverá ser fechado usando a função InternetCloseHandle .

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.

Requisitos

Confira também

Habilitando a funcionalidade da Internet

Funções WinINet