CInternetSession

Utilice la clase CInternetSession para crear e inicializar una o varias sesiones simultáneas de Internet y, si es necesario, para describir la conexión a un servidor proxy. Si su conexión a Internet debe mantenerse para la duración de una aplicación, puede crear a un miembro CInternetSession de la clase CWinApp.

Una vez que han establecido una sesión de Internet, puede llamar a OpenURL. CInternetSession analiza entonces la dirección URL para usted llamando a la función global AfxParseURL. Independientemente de su tipo de protocolo, CInternetSession interpreta el URL y gestiona para usted. Puede manejar las solicitudes de archivos locales identificados con el recurso de URL "file://". OpenURL devuelve un puntero a un objeto CStdioFile si el nombre que pasarlo es un archivo local.

Si abre una URL en un servidor de Internet mediante OpenURL, puede leer la información del sitio. Si desea realizar acciones específicas de servicio (por ejemplo, HTTP, FTP, gopher) en archivos ubicados en un servidor, debe establecer la conexión adecuada con ese servidor. Para abrir un determinado tipo de conexión directa a un determinado servicio, utilice una de las siguientes funciones de miembro:

QueryOption y SetOption le permite establecer las opciones de consulta de su período de sesiones, como valores de tiempo de espera, el número de reintentos etc.

Funciones de miembro de CInternetSession SetCookie, GetCookiey GetCookieLength proporcionan los medios para administrar la base de datos un Win32 cookie de, a través del cual los servidores y secuencias de comandos de mantengan información de estado acerca de la estación de trabajo cliente.

Durante una sesión de Internet, una transacción como una descarga de datos o la búsqueda puede tardar tiempo apreciable. El usuario que desee seguir trabajando, o que desee tener información de estado acerca de los progresos de la transacción. Para manejar este problema, CInternetSession ofrece para que la transferencia de datos y búsquedas que se produzca asychronously, que permite al usuario realizar otras tareas mientras se espera el traslado a completar. Si desea proporcionar al usuario información de Estado, o si desea controlar todas las operaciones de forma asíncrona, se deben establecer tres condiciones:

Utilice la función miembro overridable OnStatusCallback para obtener información sobre el estado de recuperación asincrónica. Para utilizar esta función miembro reemplazable, debe derivar su propia clase de CInternetSession.

Para obtener más información acerca de las operaciones asincrónicas, consulte el artículo Internet primeros pasos: WinInet en la Guía del programador de Visual C++. Para obtener información general acerca de cómo utilizar las clases WinInet de MFC, vea el artículo Internet programación con WinInet en Guía del programador de Visual C++.

&Notanbsp;CInternetSession producirá un AfxThrowNotSupportedException para los tipos de servicio no compatible. Actualmente se admiten los siguientes tipos de servicios: FTP, HTTP, gopher y archivo.

# include lt;afxinet.h>

Miembros de la clase |nbsp; Clase base | Diagrama de jerarquía

Muestras  Ejemplo de MFC FTPTREE | Ejemplo de MFC TEAR

Vea tambié&nnbsp;CInternetConnection, CHttpConnection, CFtpConnection, CGopherConnection

Index