Classe CInternetConnection

  • Articolo

Gestisce la connessione a un server Internet.

Sintassi

class CInternetConnection : public CObject

Membri

Costruttori pubblici

Nome Descrizione
CInternet Connessione ion::CInternet Connessione ion Costruisce un oggetto CInternetConnection.

Metodi pubblici

Nome Descrizione
CInternet Connessione ion::GetContext Ottiene l'ID del contesto per questo oggetto connessione.
CInternet Connessione ion::GetServerName Ottiene il nome del server associato alla connessione.
CInternet Connessione ion::GetSession Ottiene un puntatore all'oggetto CInternetSession associato alla connessione.

Operatori pubblici

Nome Descrizione
CInternet Connessione ion::operator HINTERNET Handle per una sessione Internet.

Osservazioni:

È la classe di base per le classi MFC CFtp Connessione ion, CHttp Connessione ion e CGopher Connessione ion. Ognuna di queste classi offre funzionalità aggiuntive per la comunicazione con il rispettivo server FTP, HTTP o gopher.

Per comunicare direttamente con un server Internet, è necessario disporre di un oggetto CInternetSession e di un CInternetConnection oggetto .

Per altre informazioni sul funzionamento delle classi WinInet, vedere l'articolo Programmazione Internet con WinInet.

Gerarchia di ereditarietà

CObject

CInternetConnection

Requisiti

Intestazione: afxinet.h

CInternet Connessione ion::CInternet Connessione ion

Questa funzione membro viene chiamata quando viene creato un CInternetConnection oggetto .

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

Parametri

pSession
Puntatore a un oggetto CInternetSession .

pstrServer
Puntatore a una stringa contenente il nome del server.

nPort
Numero che identifica la porta Internet per questa connessione.

dwContext
Identificatore di contesto per l'oggetto CInternetConnection . Per altre informazioni su dwContext, vedere Osservazioni.

Osservazioni:

Non chiamare mai se stessi; invece, chiamare CInternetConnection la funzione membro CInternetSession per il tipo di connessione che si vuole stabilire:

Il valore predefinito per dwContext viene inviato da MFC all'oggetto CInternetConnectionderivato da -dall'oggetto CInternetSession che ha creato l'oggetto derivato da Internet Connessione ion. Il valore predefinito è impostato su 1; Tuttavia, è possibile assegnare in modo esplicito un identificatore di contesto specifico nel costruttore CInternetSession per la connessione. L'oggetto e qualsiasi operazione eseguita verrà associato a tale ID contesto. L'identificatore di contesto viene restituito a CInternetSession::OnStatusCallback per fornire lo stato sull'oggetto con cui viene identificato. Per altre informazioni sull'identificatore di contesto, vedere l'articolo Passaggi preliminari su Internet: WinInet .

CInternet Connessione ion::GetContext

Chiamare questa funzione membro per ottenere l'ID contesto per questa sessione.

DWORD_PTR GetContext() const;

Valore restituito

ID del contesto assegnato dall'applicazione.

Osservazioni:

L'ID del contesto viene originariamente specificato in CInternetSession e si propaga alle CInternetConnectionclassi derivate da CInternetFile, a meno che non venga specificato diversamente nella chiamata a una funzione che apre la connessione. L'ID contesto è associato a qualsiasi operazione dell'oggetto specificato e identifica le informazioni sullo stato dell'operazione restituite da CInternetSession::OnStatusCallback.

Per altre informazioni sul funzionamento con altre classi WinInet per fornire informazioni sullo stato utente, vedere l'articolo Passaggi iniziali di GetContext Internet: WinInet per altre informazioni sull'identificatore di contesto.

CInternet Connessione ion::GetServerName

Chiamare questa funzione membro per ottenere il nome del server associato a questa connessione Internet.

CString GetServerName() const;

Valore restituito

Nome del server con cui l'oggetto connessione sta lavorando.

CInternet Connessione ion::GetSession

Chiamare questa funzione membro per ottenere un puntatore all'oggetto CInternetSession associato a questa connessione.

CInternetSession* GetSession() const;

Valore restituito

Puntatore a un oggetto CInternetSession associato a questo oggetto connessione Internet.

CInternet Connessione ion::operator HINTERNET

Usare questo operatore per ottenere l'handle a livello di API per la sessione Internet corrente.

operator HINTERNET() const;

Vedi anche

Classe CObject
Grafico della gerarchia