Classe CInternetConnection
Gerencia sua conexão com um servidor da Internet.
Sintaxe
class CInternetConnection : public CObject
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CInternetConnection::CInternetConnection | Constrói um objeto CInternetConnection. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CInternetConnection::GetContext | Obtém a ID de contexto para esse objeto de conexão. |
| CInternetConnection::GetServerName | Obtém o nome do servidor associado à conexão. |
| CInternetConnection::GetSession | Obtém um ponteiro para o objeto CInternetSession associado à conexão. |
Operadores públicos
| Nome | Descrição |
|---|---|
| CInternetConnection::operator HINTERNET | Um identificador para uma sessão da Internet. |
Comentários
É a classe base para classes do MFC CFtpConnection, CHttpConnection e CGopherConnection. Cada uma dessas classes fornece funcionalidade adicional para a comunicação com o respectivo servidor FTP, HTTP ou gopher.
Para comunicar diretamente um servidor de Internet, será necessário ter um objeto CInternetSession e um objeto CInternetConnection.
Para saber mais sobre como as classes WinInet funcionam, consulte o artigo Programação de Internet com WinInet.
Hierarquia de herança
CInternetConnection
Requisitos
Cabeçalho: afxinet.h
CInternetConnection::CInternetConnection
Essa função membro é chamada quando um objeto CInternetConnection é criado.
CInternetConnection(
CInternetSession* pSession,
LPCTSTR pstrServer,
INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
DWORD_PTR dwContext = 1);
Parâmetros
pSession
Um ponteiro para um objeto CInternetSession.
pstrServer
Um ponteiro para uma cadeia de caracteres contendo o nome do servidor.
nPort
O número que identifica a porta da Internet dessa conexão.
dwContext
O identificador de contexto do objeto CInternetConnection. Confira Comentários para obter mais informações sobre dwContext.
Comentários
Nunca chame CInternetConnection, em vez disso, chame a função membro CInternetSession para o tipo de conexão que você quer estabelecer:
O valor padrão para dwContext é enviado pelo MFC para o objeto derivado de CInternetConnection do objeto CInternetSession que criou o objeto derivado de InternetConnection. O padrão é definido como 1, no entanto, é possível atribuir explicitamente um identificador de contexto específico no construtor CInternetSession para a conexão. O objeto e qualquer trabalho que ele fizer serão associados a essa ID de contexto. O identificador de contexto retorna para CInternetSession::OnStatusCallback para fornecer status sobre o objeto com o qual é identificado. Confira o artigo Primeiras etapas da Internet: WinInet para mais informações sobre o identificador de contexto.
CInternetConnection::GetContext
Chame essa função membro para obter a ID de contexto dessa sessão.
DWORD_PTR GetContext() const;
Valor de retorno
A ID de contexto atribuída pelo aplicativo.
Comentários
A identificação de contexto é originalmente especificada em CInternetSession e se propaga para classes derivadas de CInternetConnection e CInternetFile, a menos que especificado de forma diferente na chamada para uma função que abre a conexão. A ID de contexto está associada a qualquer operação do objeto fornecido e identifica as informações de status da operação retornadas por CInternetSession::OnStatusCallback.
Para obter mais informações sobre como GetContext funciona com outras classes WinInet para fornecer as informações de status do usuário, confira o artigo Primeiros passos da Internet: WinInet para obter mais informações sobre o identificador de contexto.
CInternetConnection::GetServerName
Chame essa função membro para obter o nome do servidor associado a essa conexão com a Internet.
CString GetServerName() const;
Valor de retorno
O nome do servidor com o qual esse objeto de conexão está trabalhando.
CInternetConnection::GetSession
Chame essa função membro para obter um ponteiro para o objeto CInternetSession associado a essa conexão.
CInternetSession* GetSession() const;
Valor de retorno
Um ponteiro para um objeto CInternetSession associado a esse objeto de conexão com a Internet.
CInternetConnection::operator HINTERNET
Use esse operador para obter o identificador de nível de API para a sessão atual da Internet.
operator HINTERNET() const;