Clase CInternetConnection
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
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;