Compartir a través de


CInternetSession Class

Crea e inicializa sesiones únicas o varias simultáneas de internet y, si es necesario, describe la conexión a un servidor proxy.

class CInternetSession : public CObject

Members

Constructores públicos

Name

Descripción

CInternetSession::CInternetSession

Crea un objeto CInternetSession.

Métodos públicos

Name

Descripción

CInternetSession::Close

Cierra la conexión a Internet cuando finalizan a la sesión de internet.

CInternetSession::EnableStatusCallback

Establece una rutina de devolución de llamada de estado.

CInternetSession::GetContext

Cierra la conexión a Internet cuando finalizan a la sesión de internet.

CInternetSession::GetCookie

devuelve las cookies para la dirección URL especificada y todas sus direcciones URL primarias.

CInternetSession::GetCookieLength

Recupera la variable que especifica la duración de la cookie almacenada en el búfer.

CInternetSession::GetFtpConnection

Abra una sesión FTP con un servidor. Abra una sesión para el usuario.

CInternetSession::GetGopherConnection

Abra un servidor gopher para una aplicación que intenta abrir una conexión.

CInternetSession::GetHttpConnection

Abra un servidor HTTP para una aplicación que intenta abrir una conexión.

CInternetSession::OnStatusCallback

Actualiza el estado de una operación cuando se habilita la devolución de estado.

CInternetSession::OpenURL

Los análisis y abra una dirección URL.

CInternetSession::SetCookie

establece una cookie para la dirección URL especificada.

CInternetSession::SetOption

Establece opciones para la sesión de internet.

Operadores públicos

Name

Descripción

CInternetSession::operator HINTERNET

Un identificador de la sesión actual de internet.

Comentarios

Si la conexión a Internet debe mantenerse para la duración de una aplicación, puede crear un miembro de CInternetSession de la clase CWinApp.

Una vez establecida una sesión de internet, puede llamar a OpenURL. CInternetSession a analizar la dirección URL para usted llamando a la función global AfxParseURL. Sin tener en cuenta el tipo de protocolo, CInternetSession interpreta la dirección URL y la administra. Puede controlar las solicitudes de los archivos locales identificados con el recurso “file://” de la dirección URL. OpenURL devolverá un puntero a un objeto de CStdioFile si el nombre que se pasa es un archivo local.

Si abre una dirección URL en un servidor de Internet mediante OpenURL, puede leer la información del sitio. Si desea realizar (por ejemplo, HTTP, FTP, o gopher) acciones servicio-específicos en los archivos ubicados en un servidor, debe establecer la conexión correspondiente a ese servidor. Para abrir una clase determinada de conexión directamente a un servicio determinado, utilice una de las siguientes funciones miembro:

SetOption permite establecer las opciones de consulta de sesión, como valores de tiempo de espera, número de intentos, etc.

las funciones SetCookie, GetCookie, y GetCookieLength miembro deCInternetSession proporcionan un medio para administrar una base de datos de la cookie de Win32, a través de la cual los servidores y scripts conservan la información de estado de la estación de trabajo cliente.

Para obtener más información sobre las tareas de programación básicas de internet, vea el artículo Primeros pasos de internet: WinInet. Para obtener información general sobre cómo utilizar las clases WinInet de MFC, vea el artículo Internet que programa con WinInet.

Nota

CInternetSession producirá AfxThrowNotSupportedException para los tipos de servicio no compatible.Solo se admiten los tipos de servicio siguientes actualmente: FTP, HTTP, gopher, y archivo.

Jerarquía de herencia

CObject

CInternetSession

Requisitos

encabezado: afxinet.h

Vea también

Referencia

CObject (Clase)

Gráfico de jerarquías

CInternetConnection Class

CHttpConnection Class

CFtpConnection Class

CGopherConnection Class