CInternetSession::CInternetSession

CInternetSession (LPCTSTR pstrAgent = NULL, DWORD dwContext = 1, DWORD dwAccessType = INTERNET_OPEN_TYPE_PRECONFIG, 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 entidade chamando as funções de Internet (por exemplo, "Microsoft Internet Browser"). Se pstrAgent for NULL (o padrão), a estrutura chama a função global AfxGetAppName, que retorna uma seqüência de caracteres null-terminated que contém o nome do aplicativo. Alguns protocolos usam essa Cadeia de caracteres para identificar seu aplicativo no servidor.

dwContext

O identificador de contexto para a operação. dwContext identifica informações de status da operação retornadas por CInternetSession:: OnStatusCallback. O padrão é definido como 1; no entanto, você pode atribuir explicitamente uma identificação de contexto específico para a operação. O objeto e qualquer trabalho que ele faz será associados com essa identificação de contexto. Se dwFlags inclui INTERNET_FLAG_ASYNC, objetos criados por este objeto tem comportamento assíncrono enquanto uma rotina de retorno de chamada de status está registrada. Para que uma função para ser concluído de forma síncrona, dwContext tem de ser definido como zero para essa chamada.

dwAccessType

O tipo de acesso necessário. Estes são valores válidos, exatamente um dos quais pode ser fornecido:

pstrProxyName

O nome do proxy CERN preferencial se dwAccessType estiver definido como INTERNET_OPEN_TYPE_PROXY. O padrão é NULL.

pstrProxyBypass

Um ponteiro para uma Cadeia de caracteres contendo uma lista opcional de endereços de servidores. Esses endereços podem ser ignorados ao usar acesso ao proxy. Se um valor NULL for fornecido, a lista de ignoráveis serão lidos do registro. Este parâmetro é significativo somente se dwAccessType estiver definido como INTERNET_OPEN_TYPE_PROXY.

dwFlags

Indica várias opções tais como comportamento de armazenamento em cache e assíncrono. O padrão é definido como 0. Os valores possíveis incluem:

Observações

Esta função de membro é chamada quando um objeto CInternetSession é criado. CInternetSession é a primeira função de Internet chamada por um aplicativo. Ele inicializa as estruturas de dados internas e prepara-se para futuras chamadas do aplicativo.

Se dwFlags inclui INTERNET_FLAG_ASYNC, então todos os identificadores derivados este identificador terá comportamento assíncrono enquanto uma rotina de retorno de chamada de status está registrada.

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

Visão geral de CInternetSession |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext

Index