Compartir a través de

Clase CInternetConnection

  • Artículo

Administra la conexión a un servidor de Internet.

Sintaxis

class CInternetConnection : public CObject

Miembros

Constructores públicos

Nombre Descripción
CInternetConnection::CInternetConnection Construye un objeto CInternetConnection.

Métodos públicos

Nombre Descripción
CInternetConnection::GetContext Obtiene el identificador de contexto de este objeto de conexión.
CInternetConnection::GetServerName Obtiene el nombre del servidor asociado a la conexión.
CInternetConnection::GetSession Obtiene un puntero al objeto CInternetSession asociado a la conexión.

Operadores públicos

Nombre Descripción
CInternetConnection::operator HINTERNET Identificador de una sesión de Internet.

Comentarios

Es la clase base para las clases MFC CFtpConnection, CHttpConnection y CGopherConnection. Cada una de estas clases proporciona funcionalidad adicional para comunicarse con el servidor FTP, HTTP o gopher respectivo.

Para comunicarte directamente con un servidor de Internet, debes tener un objeto CInternetSession y un objeto CInternetConnection.

Para obtener más información sobre cómo funcionan las clases de WinInet, consulta el artículo Programación de Internet con WinInet.

Jerarquía de herencia

CObject

CInternetConnection

Requisitos

Encabezado: afxinet.h

CInternetConnection::CInternetConnection

Se llama a esta función miembro cuando se crea un objeto CInternetConnection.

CInternetConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    DWORD_PTR dwContext = 1);

Parámetros

pSession
Un puntero a un objeto CInternetSession.

pstrServer
Un puntero a una cadena que contiene el nombre del servidor FTP.

nPort
El número que identifica el puerto de Internet para esta conexión.

dwContext
Identificador de contexto del objeto CInternetConnection. Vea Comentarios para obtener más información sobre dwContext.

Comentarios

Nunca te llamas CInternetConnection a ti mismo; en su lugar, llama a la función miembro CInternetSession para el tipo de conexión que deseas establecer:

MFC envía el valor predeterminado de dwContext al objeto derivado CInternetConnection desde el objeto CInternetSession que creó el objeto derivado de InternetConnection. El valor predeterminado se establece en 1; sin embargo, puedes asignar explícitamente un identificador de contexto específico en el constructor CInternetSession para la conexión. El objeto y cualquier trabajo que haga se asociarán a ese identificador de contexto. El identificador de contexto se devuelve a CInternetSession::OnStatusCallback para proporcionar el estado del objeto con el que se identifica. Vea el artículo Internet First Steps: WinInet para obtener más información sobre el identificador de contexto.

CInternetConnection::GetContext

Llama a esta función miembro para obtener el identificador de contexto de esta sesión.

DWORD_PTR GetContext() const;

Valor devuelto

Identificador de contexto asignado por la aplicación.

Comentarios

El identificador de contexto se especifica originalmente en CInternetSession y se propaga a las clases derivadas de CInternetConnectionCInternetFile, a menos que se especifique de forma diferente en la llamada a una función que abre la conexión. El identificador de contexto está asociado a cualquier operación del objeto especificado e identifica la información de estado de la operación devuelta por CInternetSession::OnStatusCallback.

Para obtener más información sobre cómo funciona GetContext con otras clases de WinInet para proporcionar información de estado de usuario, consulta el artículo Primeros pasos de Internet: WinInet para obtener más información sobre el identificador de contexto.

CInternetConnection::GetServerName

Llama a esta función miembro para obtener el nombre del servidor asociado a esta conexión a Internet.

CString GetServerName() const;

Valor devuelto

Nombre del servidor con el que está trabajando este objeto de conexión.

CInternetConnection::GetSession

Llama a esta función miembro para obtener un puntero al CInternetSession objeto asociado a esta conexión.

CInternetSession* GetSession() const;

Valor devuelto

Puntero a un objeto CInternetSession asociado a este objeto de conexión a Internet.

CInternetConnection::operator HINTERNET

Usa este operador para obtener el manipulador nivel API de la sesión actual de Internet.

operator HINTERNET() const;

Consulte también

CObject (clase)
Gráfico de jerarquías