CInternetSession

Use classe CInternetSession para criar e inicializar um simples ou várias sessões simultâneas de Internet e, se necessário, para descrever a conexão com um servidor proxy. Se sua conexão com a Internet deve ser mantida para a duração de um aplicativo, você pode criar um membro CInternetSession da classe CWinApp.

Depois de estabelecer uma sessão da Internet, você pode chamar OpenURL. CInternetSession , em seguida, analisa a URL para você, chamando a função global AfxParseURL. Independentemente do seu tipo de protocolo, CInternetSession interpreta a URL e gerencia-lo para você. Ele pode manipular as solicitações de arquivos locais, identificados com o recurso de URL "file://". OpenURL irá retornar um ponteiro para um objeto CStdioFile se o nome que você passá-lo é um arquivo local.

Se você abrir uma URL em um servidor de Internet usando OpenURL, você pode ler informações do site. Se você quiser executar ações específicas do serviço (por exemplo, HTTP, FTP ou gopher) com arquivos localizados em um servidor, você deve estabelecer a conexão apropriada com esse servidor. Para abrir um tipo específico de conexão diretamente para um serviço específico, use uma das seguintes funções de membro:

QueryOption e SetOption permitem 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.

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

Durante uma sessão da Internet, uma transação como uma transferência de dados ou pesquisa pode levar tempo apreciável. O usuário pode querer continuar a trabalhar, ou pode querer ter informações de status sobre o progresso da operação. Para lidar com este problema, CInternetSession prevê pesquisas e transferência de dados ocorrer asychronously, permitindo que o usuário execute outras tarefas enquanto aguarda a transferência concluir. Se você quiser fornecer ao usuário informações de status, ou se você deseja manipular quaisquer operações de forma assíncrona, três condições devem ser definidas:

Use a função de membro substituível OnStatusCallback para obter informações de status sobre recuperação assíncrona. Para usar essa função de membro substituível, você deve derivar sua própria classe de CInternetSession.

Para obter mais informações sobre operações assíncronas, consulte o artigo Internet primeiro etapas: WinInet no Guia do programador do Visual C++. Para obter informações gerais sobre como usar as classes MFC WinInet, consulte o artigo Internet programação com WinInet no Guia do programador do Visual C++.

&Notanbsp;CInternetSession lançará um AfxThrowNotSupportedException para tipos de serviço sem suporte. Apenas os seguintes tipos de serviço são atualmente suportados: FTP, HTTP, gopher e arquivo.

# include lt;afxinet.h>

Membros da classe |nbsp; Classe base | Gráfico de hierarquia

&Nbsp amostras; MFC exemplo FTPTREE | MFC exemplo TEAR

Co&nsulte tambémnbsp;CInternetConnection, CHttpConnection, CFtpConnection, CGopherConnection

Index