CInternetSession::CInternetSession

Artigo
02/25/2013

Essa função de membro é chamada quando um objeto de CInternetSession é 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 cadeia de caracteres que identifica o nome do aplicativo ou de entidade que chamam funções da Internet (por exemplo, “navegador” Microsoft Internet).Se pstrAgent é NULO (o padrão), a estrutura chama a função AfxGetAppNameglobal, que retorna uma cadeia de caracteres NULL- finalizada que contém um nome do aplicativo.Alguns protocolos usam essa cadeia de caracteres para identificar o aplicativo para o servidor.
dwContext
O identificador de contexto para a operação.dwContext identifica as informações de status da operação retornada por CInternetSession::OnStatusCallback.A opção é definida como 1; no entanto, você pode explicitamente atribuir uma identificação de contexto específico para a operação.O objeto e todo o trabalho que faça serão associados com a identificação de contexto
dwAccessType
O tipo de acesso necessário.Estes são os valores válidos, exatamente um de que pode ser fornecido:
- INTERNET_OPEN_TYPE_PRECONFIG conectar usando configurações pré-configurados no Registro.Esse tipo de acesso for definido como o padrão.Para conectar com um proxy de TIS, defina dwAccessType para este valor; você então define o Registro adequado.
- INTERNET_OPEN_TYPE_DIRECT conecta diretamente a Internet.
- INTERNET_OPEN_TYPE_PROXY se conectar com um proxy de CERN.
Para obter informações sobre como conectar com diferentes tipos de proxies, consulte As etapas em um aplicativo típico cliente FTP.
pstrProxyName
O nome de proxy preferencial de CERN se dwAccessType é definido como INTERNET_OPEN_TYPE_PROXY.O padrão é NULO.
pstrProxyBypass
Um ponteiro para uma cadeia de caracteres que contém uma lista opcional de endereços do servidor.Esses endereços podem ser ignorados quando usar acesso de proxy.Se um valor de NULO é fornecido, a lista de desvio será lido do Registro.Esse parâmetro é significativa somente se dwAccessType é definido como INTERNET_OPEN_TYPE_PROXY.
dwFlags
Indica várias opções de cache.A opção é definida como 0.Os valores possíveis são:
- INTERNET_FLAG_DONT_CACHE não armazena em cache os dados, ou localmente nos servidores de porta de entrada.
- Operações de download deINTERNET_FLAG_OFFLINE forem atendidas por meio de cache apenas persistente.Se o item não existir no cache, um código de erro apropriada será retornado.Este sinalizador pode ser combinado com OR bit a bit (**|**Operador).

Comentários

CInternetSession é a primeira função de A chamada por um aplicativo.Inicializa estruturas de dados internas e prepara-se para chamadas futuros do aplicativo.

Se nenhuma conexão com a internet pode ser aberta, CInternetSession gera AfxThrowInternetException.