CInternetSession::CInternetSession

CInternetSession (LPCTSTR PstrAgent = NULL, DWORD DwContext = 1, DWORD DwAccessType = INTERNET_OPEN_TYPE_PRECONFIG, LPCTSTR PstrProxyName = NULL, LPCTSTR PstrProxyBypass = NULL, DWORD DwFlags = 0);

Parameter

pstrAgent

Ein Zeiger auf eine Zeichenfolge, die den Namen der Anwendung oder Entität Aufrufen der Internet-Funktionen (z. B. "Microsoft Internet Browser") identifiziert. Wenn PstrAgent NULL (Standard) ist, ruft das Framework die globale Funktion AfxGetAppName, die eine Null-terminierte Zeichenfolge mit einer Anwendung Namen zurückgibt. Einige Protokolle verwenden diese Zeichenfolge, um Ihre Anwendung auf dem Server zu identifizieren.

dwContext

Den Kontextbezeichner für den Betrieb. DwContext identifiziert den Betrieb von CInternetSession::OnStatusCallbackzurückgegebenen Status-Informationen. Der Standardwert ist auf 1 festgelegt. Allerdings können Sie explizit eine bestimmten Kontext-ID für den Vorgang zuweisen. Das Objekt und vor jeder Arbeit, die sie tut, werden diese Kontext-ID zugeordnet werden. Wenn DwFlags INTERNET_FLAG_ASYNCenthält, haben von diesem Objekt erstellten Objekte asynchrones Verhalten, solange eine Status-Callback-Routine registriert ist. In Reihenfolge für eine Funktion synchron abgeschlossen werden hat DwContext für diesen Anruf auf NULL festgelegt werden.

dwAccessType

Die Art des Zugriffs erforderlich. Im folgenden sind gültige Werte, genau, die davon geliefert werden:

• I&NTERNET_OPEN_TYPE_PRECONFIGNbsp;  (In der Registrierung) vorkonfiguriert. Dieser Art wird als Standard festgelegt.
  
  
• I&NTERNET_OPEN_TYPE_DIRECTNbsp;  Direkt zum Internet.
  
  
• I&NTERNET_OPEN_TYPE_PROXYNbsp;  Über CERN-proxy.

pstrProxyName

Der Name des bevorzugten CERN-Proxy wenn DwAccessType als INTERNET_OPEN_TYPE_PROXYfestgelegt ist. Der Standardwert ist NULL.

pstrProxyBypass

Ein Zeiger auf eine Zeichenfolge mit eine optionale Liste mit Serveradressen. Diese Adressen können umgangen werden, wenn Sie Proxy-Zugang verwenden. Wenn ein NULL -Wert angegeben wird, wird die Umgehungsliste aus der Registrierung gelesen werden. Dieser Parameter ist nur relevant, wenn DwAccessType auf INTERNET_OPEN_TYPE_PROXY festgelegt ist.

dwFlags

Gibt verschiedene Optionen wie z. B. Zwischenspeicherung und asynchrone Verhalten. Der Standardwert ist auf 0 festgelegt. Mögliche Werte sind:

• I&NTERNET_FLAG_DONT_CACHENbsp;  Die Daten sollten nicht zwischengespeichert werden, entweder lokal oder in einer Gateway-Servern.
  
  
• I&NTERNET_FLAG_ASYNCNbsp;  Künftige Operationen für dieses Objekt können mit ERROR_IO_PENDINGfehlschlagen. Ein Status-Rückruf wird mit INTERNET_STATUS_REQUEST_COMPLETE gemacht werden, wenn der Vorgang abgeschlossen ist. Dieser Rückruf wird in einem Thread anderen als dem für die ursprüngliche Anforderung. EnableStatusCallback herstellen eine Status-Callback-Routine muss aufgerufen werden, oder die Funktionen synchron abgeschlossen sein.
  
  
• I&NTERNET_FLAG_OFFLINENbsp;  Download-Vorgänge durch den persistenten Cache nur zufrieden sind. Wenn das Element nicht im Cache vorhanden ist, wird ein entsprechende Fehlercode zurückgegeben. Dieses Flag kann mit dem bitweisen Operator OR (|) kombiniert werden.

Bemerkungen

Dieser Member-Funktion wird aufgerufen, wenn ein CInternetSession -Objekt erstellt wird. CInternetSession ist die erste Internet-Funktion, die von einer Anwendung aufgerufen. Interne Datenstrukturen initialisiert und bereitet für zukünftige Aufrufe aus der Anwendung.

Wenn DwFlags INTERNET_FLAG_ASYNCenthält, haben alle Griffe dieses Handle abgeleitet asynchrones Verhalten, solange eine Status-Callback-Routine registriert ist.

Wenn keine Internet-Verbindung geöffnet werden kann, löst CInternetSession ein AfxThrowInternetException.

CInternetSession Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext