Classe di CInternetSession

Articolo
03/05/2013

Crea e inizializza le singole o più sessioni Internet simultanee e, se necessario, vengono descritte la connessione a un server proxy.

class CInternetSession : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CInternetSession::CInternetSession	Costruisce un oggetto CInternetSession.

Metodi pubblici

Nome	Descrizione
CInternetSession::Close	Chiude la connessione Internet quando la sessione Internet viene interrotta.
CInternetSession::EnableStatusCallback	Stabilisce una routine di callback dello stato.
CInternetSession::GetContext	Chiude la connessione Internet quando la sessione Internet viene interrotta.
CInternetSession::GetCookie	Il cookie viene restituito per l'url specificato e tutto il relativo elemento padre URL.
CInternetSession::GetCookieLength	Recupera la variabile che specifica la durata del cookie memorizzate nel buffer.
CInternetSession::GetFtpConnection	Apre una sessione FTP con un server.Collega l'utente.
CInternetSession::GetGopherConnection	Apre un server gopher per un'applicazione che sta tentando di aprire una connessione.
CInternetSession::GetHttpConnection	Apre un server HTTP per un'applicazione che sta tentando di aprire una connessione.
CInternetSession::OnStatusCallback	Aggiorna lo stato di un'operazione quando il callback dello stato è abilitato.
CInternetSession::OpenURL	Analizza e apre un URL.
CInternetSession::SetCookie	Imposta un cookie per l'url specificato.
CInternetSession::SetOption	Imposta le opzioni della sessione Internet.

Operatori pubblici

Nome	Descrizione
CInternetSession::operator HINTERNET	Handle alla sessione corrente Internet.

Note

Se la connessione Internet deve essere gestita per la durata di un'applicazione, è possibile creare un membro CInternetSession della classe CWinApp.

Una volta stabilita una connessione Internet, è possibile chiamare OpenURL.CInternetSession quindi analizza l'url automaticamente chiamando la funzione globale AfxParseURL.Indipendentemente dal tipo di protocollo, CInternetSession interpreta l'url e lo gestisce automaticamente.Può gestire richieste di file locali identificati con la risorsa "file://" URL.OpenURL restituirà un puntatore a un oggetto CStdioFile se il nome passato è un file locale.

Se si apre un URL in un server Internet utilizzando OpenURL, è possibile leggere informazioni dal sito.Se si desidera eseguire, ad esempio HTTP, FTP, o) gopher le azioni servizio specifiche sui file trovano su un server, è necessario stabilire la connessione adeguata al server.Per aprire un particolare tipo di connessione direttamente a un particolare servizio, utilizzare una delle seguenti funzioni membro:

GetGopherConnection per aprire una connessione a un servizio di gopher.
GetHttpConnection per aprire una connessione a un servizio HTTP.
GetFtpConnection per aprire una connessione a un servizio FTP.

SetOption consente di impostare le opzioni query della sessione, come valori di timeout, numero di tentativi, e così via.

Le funzioni membro SetCookie, GetCookiee GetCookieLength diCInternetSession consentono di gestire un database dei cookie Win32, tra cui i server e script mantengono le informazioni sullo stato della workstation client.

Per ulteriori informazioni sulle attività di base di programmazione per Internet, vedere l'articolo Primi passaggi Internet: WinInet.Per informazioni generali sull'utilizzo delle classi MFC ATL, vedere l'articolo Programmazione per Internet con ATL.

[!NOTA]

CInternetSession genererà AfxThrowNotSupportedException per i tipi di servizi non supportati.Solo i tipi seguenti di servizio sono attualmente supportati: FTP, HTTP, gopher e file.