CInternetSession::CInternetSession

Artikel
02/26/2013

Diese Memberfunktion wird aufgerufen, wenn ein CInternetSession-Objekt erstellt wird.

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

Parameter

pstrAgent
Ein Zeiger auf eine Zeichenfolge, die den Namen der Anwendung oder der Entität identifiziert, die die Internet-Funktionen aufrufen (beispielsweise, "Microsoft-Internetbrowser").Wenn pstrAgentNULL (der Standardwert), ruft das Framework die globale Funktion AfxGetAppName auf, die eine auf NULL endende Zeichenfolge zurückgibt, die den Namen der Anwendung enthält.Einige Protokolle verwenden diese Zeichenfolge, um die Anwendung den Server zu identifizieren.
dwContext
Der Kontextbezeichner für den Vorgang.dwContext identifiziert die Statusinformationen des Vorgangs, die von CInternetSession::OnStatusCallback zurückgegeben werden.Der Standard ist auf 1 festgelegt; Sie können jedoch eine bestimmte Kontext-ID für den Vorgang explizit zuweisen.Das Objekt und alle Aufgaben, die es ausgegeben, werden mit dieser Kontext ID zugeordnet
dwAccessType
Der Typ des Zugriffs erfordert.Im Folgenden werden gültige Werte genau, von denen einer möglicherweise angegeben wird:
- INTERNET_OPEN_TYPE_PRECONFIG schließen mithilfe der vordefinierten Einstellungen in der Registrierung an.Dieser Zugriffstyp wird als Standard festgelegt.Um durch einen TIS-Proxy herzustellen, legen Sie dwAccessType auf diesen Wert fest; Legen Sie dann die Registrierung entsprechend fest.
- INTERNET_OPEN_TYPE_DIRECT schließen direkt an Internet an.
- INTERNET_OPEN_TYPE_PROXY schließen durch einen CERN-Proxy an.
Informationen zum Anschließen an verschiedene Typen von Proxy, finden Sie unter Schritte in einer typischen FTP-Clientanwendung.
pstrProxyName
Der Name des bevorzugten CERN-Proxys, wenn dwAccessType als INTERNET_OPEN_TYPE_PROXY festgelegt ist.Der Standardwert ist NULL.
pstrProxyBypass
Ein Zeiger auf eine Zeichenfolge, die eine optionale Liste der Serveradressen enthält.Diese Adressen umgangen werden kann, wenn der Proxyzugriff verwendet.Wenn ein NULL-Wert angegeben, wird die Umgehungsliste aus der Registrierung gelesen.Dieser Parameter ist nur sinnvoll, wenn dwAccessType zu INTERNET_OPEN_TYPE_PROXY festgelegt ist.
dwFlags
Gibt verschiedene Zwischenspeicherungsoptionen an.Der Standard ist auf 0 festgelegt.Das mögliche Zu den Werten zählen:
- INTERNET_FLAG_DONT_CACHE zwischenspeichern, die Daten entweder nicht lokal noch in einem Gatewayservern.
- INTERNET_FLAG_OFFLINE Downloadvorgänge sind nur durch den permanenten Cache erfüllt.Wenn das Element nicht im Cache vorhanden ist, wird ein entsprechender Fehlercode zurückgegeben.Dieses Flag wird mit bitweisen OR kombiniert werden (**|**Operator).

Hinweise

CInternetSession ist die erste Internet-Funktion, die von einer Anwendung aufgerufen wird.Es initialisiert interne Datenstrukturen und kann sich für künftige Aufrufe von der Anwendung vor.

Wenn keine Internetverbindung geöffnet werden kann, löst CInternetSessionAfxThrowInternetException aus.