CInternetSession::CInternetSession

Articolo
06/10/2015

Questa funzione membro viene chiamata a un oggetto CInternetSession viene creato.

CInternetSession( 
   LPCTSTR pstrAgent = NULL, 
   DWORD_PTR dwContext = 1, 
   DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS, 
   LPCTSTR pstrProxyName = NULL, 
   LPCTSTR pstrProxyBypass = NULL, 
   DWORD dwFlags = 0  
);

Parametri

pstrAgent
Un puntatore a una stringa che identifica il nome dell'applicazione o di entità che chiama le funzioni Internet (ad esempio, "browser di Microsoft Internet"). Se pstrAgent è NULL (impostazione predefinita), il framework chiama la funzione globale AfxGetAppName, che restituisce una stringa con terminazione null che contiene il nome dell'applicazione. I protocolli utilizza questa stringa per identificare l'applicazione al server.
dwContext
l'identificatore di contesto per l'operazione. dwContext identifica le informazioni sullo stato dell'operazione restituite da CInternetSession::OnStatusCallback. L'impostazione predefinita è impostata su 1; tuttavia, è possibile assegnare in modo esplicito un ID di contesto specifico per l'operazione. L'oggetto e tutto il lavoro svolto verranno associati all'identificazione di contesto
dwAccessType
Il tipo di accesso richiesto. Di seguito sono valori validi, esattamente uno dei quali può essere attribuito:
- INTERNET_OPEN_TYPE_PRECONFIG si connette utilizzando le impostazioni preconfigurate nel Registro di sistema. Questo tipo di accesso impostato come predefinito. Per connettersi a un proxy di TIS, impostare dwAccessType a questo valore; quindi impostarne il Registro di sistema in modo appropriato.
- INTERNET_OPEN_TYPE_DIRECT si connette direttamente a Internet.
- INTERNET_OPEN_TYPE_PROXY si connette a un proxy di CERN.
Per informazioni sulla connessione con diversi tipi proxy di, vedere Passaggi in un'applicazione client tipica FTP.
pstrProxyName
Il nome del CERN preferito proxy se dwAccessType viene impostato come INTERNET_OPEN_TYPE_PROXY. l'impostazione predefinita è NULL.
pstrProxyBypass
Un puntatore a una stringa contenente un elenco facoltativo degli indirizzi del server. Gli indirizzi possono essere ignorati durante l'utilizzo dell'accesso del proxy. Se un valore null viene fornito, l'elenco di esclusione verrà letta dal Registro di sistema. Questo parametro è significativo solo se dwAccessType è impostato su INTERNET_OPEN_TYPE_PROXY.
dwFlags
Indica le varie opzioni di memorizzazione nella cache. L'impostazione predefinita è impostata su 0. I valori possibili sono:
- INTERNET_FLAG_DONT_CACHE non memorizza i dati nella cache, locale o in alcuni gateway server.
- Le operazioni di download diINTERNET_FLAG_OFFLINE vengono soddisfatte dalla cache solo persistente. Se l'elemento non esiste nella cache, un codice di errore appropriato viene restituito. Questo flag può essere combinato con OR bit per bit ( **|**Operatore).

Note

CInternetSession è la prima funzione Internet chiamata da un'applicazione. Inizializza le strutture di dati interne e prepara per le chiamate future dall'applicazione.

Se non la connessione Internet può essere aperta, CInternetSession generato AfxThrowInternetException.