CInternetSessions-Klasse

Artikel
02/26/2013

Erstellt und initialisiert einzelne oder mehrere gleichzeitigen Internet-Sitzungen und beschreibt ggf. die Verbindung zu einem Proxyserver.

class CInternetSession : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CInternetSession::CInternetSession	Erstellt ein CInternetSession-Objekt.

Öffentliche Methoden

Name	Description
CInternetSession::Close	Schließt die Internetverbindung, wenn die Internet-Sitzung beendet wird.
CInternetSession::EnableStatusCallback	Richtet eine Statusrückrufroutine ein.
CInternetSession::GetContext	Schließt die Internetverbindung, wenn die Internet-Sitzung beendet wird.
CInternetSession::GetCookie	EINGABETASTEcookien für die angegebene URL und der gesamten übergeordnete Element URL.
CInternetSession::GetCookieLength	Ruft die Variable ab, die die Länge des Cookies angeben, das im Puffer gespeichert wird.
CInternetSession::GetFtpConnection	Öffnet eine FTP-Sitzung mit einem Server.Benachrichtigt den Benutzer an.
CInternetSession::GetGopherConnection	Öffnet einen Gopherserver für eine Anwendung, die versucht, eine Verbindung zu öffnen.
CInternetSession::GetHttpConnection	Öffnet einen HTTP-Server für eine Anwendung, die versucht, eine Verbindung zu öffnen.
CInternetSession::OnStatusCallback	Aktualisiert den Status eines Vorgangs, wenn Statusrückruf aktiviert ist.
CInternetSession::OpenURL	Analysiert und öffnet eine URL.
CInternetSession::SetCookie	Legt ein Cookie für das angegebene URL fest.
CInternetSession::SetOption	Legt Optionen für die Internet-Sitzung fest.

Öffentliche Operatoren

Name	Description
CInternetSession::operator HINTERNET	Ein Handle zur aktuellen Internet-Sitzung.

Hinweise

Wenn die Internetverbindung während der Dauer einer Anwendung beibehalten werden müssen, können Sie einen CInternetSession-Member der Klasse CWinApp erstellen.

Nachdem Sie eine Internet-Sitzung hergestellt haben, können Sie OpenURL aufrufen.CInternetSession analysiert dann die URL für Sie, indem es die globale Funktion AfxParseURL aufruft.Unabhängig von den Protokolltyp interpretiert CInternetSession die URL und verwaltet es für Sie.Es kann Anforderungen für die lokalen Dateien bearbeiten, die der URL-Ressource "file://" identifiziert werden.OpenURL gibt einen Zeiger auf einen CStdioFile-Objekt zurück, wenn der Name, den Sie ihn übergeben, eine lokale Datei ist.

Wenn Sie eine URL auf einem Internetserver mithilfe OpenURL öffnen, können Sie Informationen aus der Site lesen.Wenn Sie dienstspezifische (beispielsweise, HTTP, FTP, oder Gopher) Aktionen für die Dateien auf einem Server ausführen möchten, müssen Sie die entsprechende Verbindung mit diesem Server herstellen.Um eine bestimmte Art von Verbindung direkt an einen bestimmten Dienst zu öffnen, verwenden Sie eine der folgenden Memberfunktionen:

GetGopherConnection, um eine Verbindung zu einem Gopher-Dienst zu öffnen.
GetHttpConnection, um eine Verbindung zu einem HTTP-Dienst zu öffnen.
GetFtpConnection, um eine Verbindung zu einem FTP-Dienst zu öffnen.

SetOption ermöglicht es Ihnen, die Abfrageoptionen der Sitzung, wie Timeoutwerte festzulegen, Zahl wiederholt, u. a.

CInternetSession-Memberfunktionen SetCookie, GetCookie und GetCookieLength bieten die Möglichkeit, um eine Win32-Cookiedatenbank verwalten, durch die Server und Skripts Zustandsinformationen über die Clientarbeitsstation beibehalten.

Weitere Informationen zu den Aufgaben des grundlegenden Internet, finden Sie im Artikel Internet-erste Schritte: WinInet-Klassen.Allgemeine Informationen über die Verwendung der Klassen MFC-WinInet-Unterstützung, finden Sie im Artikel Webprogrammierung mit WinInet-Klassen.

Hinweis
CInternetSession löst AfxThrowNotSupportedException für nicht unterstützte Diensttypen aus.Nur die folgenden Diensttypen werden derzeit unterstützt: FTP, HTTP, Gopher und Datei.