Classe CInternetSession

Artigo
06/10/2015

Cria e inicializa única ou várias sessões simultâneas da Internet e, se necessário, descreve a conexão a um servidor proxy.

class CInternetSession : public CObject

Membros

Construtores public

Nome	Descrição
CInternetSession::CInternetSession	Constrói um objeto de CInternetSession .

Métodos públicos

Nome	Descrição
CInternetSession::Close	Fecha a conexão com a internet quando a sessão da Internet é finalizada.
CInternetSession::EnableStatusCallback	Estabelece uma rotina de retorno de chamada de status.
CInternetSession::GetContext	Fecha a conexão com a internet quando a sessão da Internet é finalizada.
CInternetSession::GetCookie	Cookies de retorna para o URL especificado e todos os seus URL pai.
CInternetSession::GetCookieLength	Recupera a variável que especifica o comprimento do cookie armazenado em buffer.
CInternetSession::GetFtpConnection	Abre uma sessão de um servidor FTP. Insere o usuário.
CInternetSession::GetGopherConnection	Abre um servidor de Gopher para um aplicativo que está tentando abrir uma conexão.
CInternetSession::GetHttpConnection	Abre um servidor HTTP para um aplicativo que está tentando abrir uma conexão.
CInternetSession::OnStatusCallback	Atualizar o status de uma operação quando o retorno de chamada de status está ativado.
CInternetSession::OpenURL	Analisa e abre uma URL.
CInternetSession::SetCookie	Define um cookie para o URL especificado.
CInternetSession::SetOption	Defina opções para a sessão da Internet.

Operadores públicos

Nome	Descrição
CInternetSession::operator HINTERNET	Um identificador para a sessão atual da Internet.

Comentários

Se sua conexão com a internet devem ser mantidas para a duração de um aplicativo, você pode criar um membro de CInternetSession da classe CWinApp.

Uma vez que você estabeleceu uma sessão da Internet, você pode chamar OpenURL. CInternetSession analisa o URL para você chamar a função global AfxParseURL. Independentemente do tipo de protocolo, CInternetSession interpreta o URL e gerencie para você. Pode manipular as solicitações para os arquivos locais identificados com o recurso “file://” URL. OpenURL retornará um ponteiro para um objeto de CStdioFile se o nome que você passa o é um arquivo local.

Se você abrir um URL em um servidor da web que usa OpenURL, você pode ler informações do site. Se você deseja executar (por exemplo, HTTP, FTP, ou) Gopher ações serviço- específicas em arquivos localizados em um servidor, você deve estabelecer a conexão com o servidor apropriado. Para abrir um tipo específico de conexão diretamente a um determinado serviço, use uma das seguintes funções de membro:

GetGopherConnection para abrir uma conexão a um serviço de Gopher.
GetHttpConnection para abrir uma conexão a um serviço HTTP.
GetFtpConnection para abrir uma conexão a um serviço FTP.

SetOption permite que você defina as opções de consulta de sua sessão, como valores de tempo limite, o número de tentativas, e assim por diante.

As funções de membro SetCookie, GetCookie, e GetCookieLength deCInternetSession fornecem os meios para gerenciar um banco de dados do cookie Win32, através dos servidores e scripts mantêm informações de estado sobre a estação de trabalho do cliente.

Para obter mais informações sobre Internet básico que tarefas de programação, consulte o artigo Primeiras etapas da Internet: WinInet. Para obter informações gerais sobre como usar as classes MFC WinInet, consulte o artigo Internet que programa com WinInet.

Dica

CInternetSession irá acionar AfxThrowNotSupportedException para tipos de serviço sem suporte.Somente os seguintes tipos de serviço são atualmente suportados: FTP, HTTP, e Gopher arquivo.