CInternetSession::CInternetSession

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

Parametri

pstrAgent

Puntatore a una stringa che identifica il nome dell'applicazione o entità chiamando le funzioni Internet (ad esempio, "Microsoft Internet Browser"). Se pstrAgent è NULL (impostazione predefinita), il framework chiama la funzione globale AfxGetAppName, che restituisce una stringa null-terminated contenente il nome di un'applicazione. Alcuni protocolli di usano 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. Il valore predefinito è impostato su 1; Tuttavia, è possibile assegnare in modo esplicito un ID di contesto specifico per l'operazione. L'oggetto e qualsiasi lavoro che non verrà associati a quell'ID contesto. Se dwFlags include INTERNET_FLAG_ASYNC, gli oggetti creati da questo oggetto hanno comportamento asincrono, finché una routine di richiamata lo status è stata registrata. Al fine di una funzione per essere completata in modo sincrono, deve essere impostato a zero per quella chiamata dwContext.

dwAccessType

Il tipo di accesso richiesto. Di seguito sono valori validi, esattamente una delle quali, possa essere fornita:

pstrProxyName

Il nome del proxy CERN preferito se dwAccessType è impostato come INTERNET_OPEN_TYPE_PROXY. Il valore predefinito è NULL.

pstrProxyBypass

Puntatore a una stringa contenente un elenco facoltativo di indirizzi del server. Questi indirizzi possono essere aggirati quando si utilizza l'accesso a un proxy. Se viene fornito un valore NULL , l'elenco di bypass leggerà dal Registro di sistema. Questo parametro è significativo solo se dwAccessType è impostato su INTERNET_OPEN_TYPE_PROXY.

dwFlags

Indica le varie opzioni, come comportamento asincrono e memorizzazione nella cache. Il valore predefinito è impostato su 0. I valori possibili includono:

Osservazioni

Questa funzione membro viene chiamata quando viene creato un oggetto CInternetSession . CInternetSession è la prima funzione Internet chiamata da un'applicazione. Inizializza le strutture di dati interne e si prepara per le chiamate future dall'applicazione.

Se dwFlags include INTERNET_FLAG_ASYNC, allora il tutte le maniglie derivate da questo handle avrà comportamento asincrono in finché una routine di richiamata lo status è registrata.

Se alcuna connessione a Internet non può essere aperto, CInternetSession genera un' AfxThrowInternetException.

CInternetSession panoramica |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CInternetSession::Close, CInternetSession:: EnableStatusCallback, CInternetSession::GetContext

Index