CInternetSession::CInternetSession

Artigo
08/25/2010

Esta função de membro é chamada quando um CInternetSession objeto é criado.

CInternetSession(
   LPCTSTR pstrAgent = NULL,
   DWORD_PTR dwContext = 1,
   DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS,
   LPCTSTR pstrProxyName = NULL,
   LPCTSTR pstrProxyBypass = NULL,
   DWORD dwFlags = 0 
);

Parâmetros

pstrAgent
Um ponteiro para uma seqüência de caracteres que identifica o nome do aplicativo ou da entidade chamando as funções de Internet (por exemplo, "Microsoft Internet navegador").If pstrAgent é NULO (padrão), a estrutura chama a função global AfxGetAppName, que retorna uma seqüência de caracteres terminada com nulo que contém o nome de um aplicativo.Alguns protocolos usam esta seqüência para identificar seu aplicativo para o servidor.
dwContext
O identificador de contexto para a operação.dwContext identifica as informações de status da operação retornadas por CInternetSession::OnStatusCallback.O padrão é definido como 1; no entanto, você pode atribuir explicitamente uma ID de contexto específico para a operação.O objeto e qualquer trabalho que será associados a essa ID de contexto.
dwAccessType
O tipo de acesso necessário.Valores válido, exatamente um dos quais pode ser fornecido são:
- INTERNET_OPEN_TYPE_PRECONFIG Conectar-se usando configurações predefinidas do registro.Esse tipo de acesso é conjunto sistema autônomo padrão.Para se conectar por meio de um proxy TIS, conjunto dwAccessType como esse valor; você conjunto o registro apropriadamente.
- INTERNET_OPEN_TYPE_DIRECT Conecte diretamente à Internet.
- INTERNET_OPEN_TYPE_PROXY Se conectar por meio de um proxy CERN.
Para obter informações sobre a conexão com tipos diferentes de proxies, consulte Etapas de um aplicativo cliente FTP típica.
pstrProxyName
O nome do proxy CERN preferencial se dwAccessType é conjunto sistema autônomo INTERNET_OPEN_TYPE_PROXY. O padrão é NULO.
pstrProxyBypass
Um ponteiro para uma seqüência de caracteres que contém uma lista de endereços de servidor opcional.Esses endereços podem ser ignorados ao usar o acesso ao proxy.If a NULOé fornecido um valor de , lista de ignoráveis serão lidos do registro.Este parâmetro é significativo apenas se dwAccessType é conjunto para INTERNET_OPEN_TYPE_PROXY.
dwFlags
Indica a várias opções de cache.O padrão é definido como 0.Os valores possíveis incluem:
- INTERNET_FLAG_DONT_CACHE Não armazenar em cache os dados, localmente ou em todos os servidores gateway.
- INTERNET_FLAG_OFFLINE Baixe as operações de esteja satisfeito por cache persistente. Se o item não existir no cache, será retornado um código de erro apropriada.Esse sinalizar deve ser combinado com o bit a bit OR (|) operador.

Comentários

CInternetSession é a primeira função Internet chamada por um aplicativo.Ele inicializa as estruturas de dados internas e prepara para chamadas futuras do aplicativo.

Se nenhuma conexão com a Internet pode ser aberto, CInternetSession lança um AfxThrowInternetException.