Classe CInternetConnection
Gestisce la connessione a un server Internet.
Sintassi
class CInternetConnection : public CObject
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CInternetConnection::CInternetConnection | Costruisce un oggetto CInternetConnection. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CInternetConnection::GetContext | Ottiene l'ID del contesto per questo oggetto connessione. |
| CInternetConnection::GetServerName | Ottiene il nome del server associato alla connessione. |
| CInternetConnection::GetSession | Ottiene un puntatore all'oggetto CInternetSession associato alla connessione. |
Operatori pubblici
| Nome | Descrizione |
|---|---|
| CInternetConnection::operator HINTERNET | Handle per una sessione Internet. |
Osservazioni:
È la classe di base per le classi MFC CFtpConnection, CHttpConnection e CGopherConnection. 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à
CInternetConnection
Requisiti
Intestazione: afxinet.h
CInternetConnection::CInternetConnection
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 InternetConnection. 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 .
CInternetConnection::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.
CInternetConnection::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.
CInternetConnection::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.
CInternetConnection::operator HINTERNET
Usare questo operatore per ottenere l'handle a livello di API per la sessione Internet corrente.
operator HINTERNET() const;