CInternetSession Class

Artículo
06/10/2015

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:

GetGopherConnection a abrir una conexión a un servicio de gopher.
GetHttpConnection a abrir una conexión a un servicio HTTP.
GetFtpConnection a abrir una conexión a un servicio FTP.

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.