Classe CInternetConnection

Gere a sua ligação a um servidor de Internet.

Sintaxe

class CInternetConnection : public CObject

Membros

Construtores Públicos

Métodos Públicos

Operadores Públicos

Observações

É a classe base para as classes MFC CFtpConnection, CHttpConnection e CGopherConnection. Cada uma destas classes fornece funcionalidades adicionais para comunicar com o respetivo servidor FTP, HTTP ou gopher.

Para comunicar diretamente com um servidor da Internet, deve ter um objeto CInternetSession e um CInternetConnection objeto.

Para saber mais sobre como funcionam as classes WinInet, consulte o artigo Programação na Internet com WinInet.

Hierarquia de herança

CObject

CInternetConnection

Requerimentos

Cabeçalho: afxinet.h

ConexãoCinternet::ConexãoCinternet.

Esta função membro é chamada quando um CInternetConnection objeto é 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 string contendo o nome do servidor.

nPort
O número que identifica a porta de Internet para esta ligação.

dwContext
O identificador de contexto para o CInternetConnection objeto. Consulte Observações para mais informações sobre dwContext.

Observações

Nunca te chamas CInternetConnection a ti próprio; em vez disso, chama a função membro CInternetSession para o tipo de ligação que queres estabelecer:

• CInternetSession::GetFtpConnection

• CInternetSession::GetHttpConnection

• Sessão de Cinternet::GetGopherConnection

O valor padrão para dwContext é enviado pelo MFC para o CInternetConnectionobjeto derivado em a partir do objeto CInternetSession que criou o objeto derivado do InternetConnection. O padrão é definido para 1; no entanto, pode atribuir explicitamente um identificador de contexto específico no construtor CInternetSession para a ligação. O objeto e qualquer trabalho que ele faça estarão associados a esse ID de contexto. O identificador de contexto é devolvido a CInternetSession::OnStatusCallback para fornecer o estado do objeto com o qual está identificado. Consulte o artigo Internet First Steps: WinInet para mais informações sobre o identificador de contexto.

CInternetConnection::GetContext

Chame esta função membro para obter o ID de contexto desta sessão.

DWORD_PTR GetContext() const;

Valor de retorno

O ID de contexto atribuído pela aplicação.

Observações

O ID de contexto é originalmente especificado em CInternetSession e propaga-se para CInternetConnection- e classes derivadas de ficheiros CInternetFile, a menos que seja especificado de forma diferente na chamada a uma função que abre a ligação. O ID de contexto está associado a qualquer operação do objeto dado e identifica a informação de estado da operação devolvida por CInternetSession::OnStatusCallback.

Para mais informações sobre como GetContext funciona com outras classes WinInet para fornecer o estado do utilizador, consulte o artigo Internet First Steps: WinInet para mais informações sobre o identificador de contexto.

CInternetConnection::GetServerName

Ligue para esta função de membro para obter o nome do servidor associado a esta ligação à Internet.

CString GetServerName() const;

Valor de retorno

O nome do servidor com que este objeto de ligação está a trabalhar.

Cinner Connection::GetSession

Chame esta função membro para obter um ponteiro para o CInternetSession objeto associado a esta ligação.

CInternetSession* GetSession() const;

Valor de retorno

Um ponteiro para um objeto CInternetSession associado a este objeto de ligação à Internet.

Cinner netConnection::operator HINTERNET

Use este operador para obter o handle ao nível da API para a sessão atual da Internet.

operator HINTERNET() const;

Consulte também

Classe CObject
Gráfico de Hierarquia