CInternetSession::CInternetSession

Artigo
06/10/2015

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.