Freigeben über

CInternetConnection-Klasse

  • Artikel

Verwaltet die Verbindung mit einem Internetserver.

Syntax

class CInternetConnection : public CObject

Member

Öffentliche Konstruktoren

Name Beschreibung
CInternet Verbinden ion::CInternet Verbinden ion Erstellt ein CInternetConnection-Objekt.

Öffentliche Methoden

Name Beschreibung
CInternet Verbinden ion::GetContext Ruft die Kontext-ID für dieses Verbindungsobjekt ab.
CInternet Verbinden ion::GetServerName Ruft den Namen des Servers ab, der der Verbindung zugeordnet ist.
CInternet Verbinden ion::GetSession Ruft einen Zeiger auf das CInternetSession -Objekt ab, das der Verbindung zugeordnet ist.

Öffentliche Operatoren

Name Beschreibung
CInternet Verbinden ion::operator HINTERNET Ein Handle für eine Internetsitzung.

Hinweise

Es ist die Basisklasse für die MFC-Klassen CFtp Verbinden ion, CHttp Verbinden ion und CGopher Verbinden ion. Jede dieser Klassen bietet zusätzliche Funktionen für die Kommunikation mit dem jeweiligen FTP-, HTTP- oder Gopher-Server.

Um direkt mit einem Internetserver zu kommunizieren, müssen Sie über ein CInternetSession-Objekt und ein CInternetConnection Objekt verfügen.

Weitere Informationen dazu, wie die WinInet-Klassen funktionieren, finden Sie im Artikel "Internet Programming with WinInet".

Vererbungshierarchie

CObject

CInternetConnection

Anforderungen

Kopfzeile: afxinet.h

CInternet Verbinden ion::CInternet Verbinden ion

Diese Memberfunktion wird aufgerufen, wenn ein CInternetConnection Objekt erstellt wird.

CInternetConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    DWORD_PTR dwContext = 1);

Parameter

pSession
Ein Zeiger auf ein CInternetSession-Objekt .

pstrServer
Ein Zeiger auf eine Zeichenfolge, die den Servernamen enthält.

nPort
Die Nummer, die den Internetport für diese Verbindung identifiziert.

dwContext
Der Kontextbezeichner für das CInternetConnection Objekt. Weitere Informationen zu dwContext finden Sie in den Hinweisen.

Hinweise

Sie rufen sich nie selbst auf CInternetConnection . Rufen Sie stattdessen die CInternetSession-Memberfunktion für den Verbindungstyp auf, den Sie einrichten möchten:

Der Standardwert für dwContext wird von MFC an das CInternetConnectionvom CInternetSession-Objekt abgeleitete Objekt gesendet, das das internet Verbinden ion-abgeleitete Objekt erstellt hat. Der Standardwert ist auf 1 festgelegt; Sie können jedoch explizit einen bestimmten Kontextbezeichner im CInternetSession-Konstruktor für die Verbindung zuweisen. Das Objekt und jede Arbeit, die es tut, wird dieser Kontext-ID zugeordnet. Der Kontextbezeichner wird an CInternetSession::OnStatusCallback zurückgegeben, um den Status des Objekts bereitzustellen, mit dem es identifiziert wird. Weitere Informationen zum Kontextbezeichner finden Sie im Artikel "Internet First Steps: WinInet ".

CInternet Verbinden ion::GetContext

Rufen Sie diese Memberfunktion auf, um die Kontext-ID für diese Sitzung abzurufen.

DWORD_PTR GetContext() const;

Rückgabewert

Die vom Anwendung zugewiesene Kontext-ID.

Hinweise

Die Kontext-ID wird ursprünglich in CInternetSession angegeben und an - und von CInternetFile abgeleitete CInternetConnectionKlassen weitergegeben, es sei denn, im Aufruf einer Funktion, die die Verbindung öffnet, anders angegeben. Die Kontext-ID ist jedem Vorgang des angegebenen Objekts zugeordnet und identifiziert die Statusinformationen des Vorgangs, die von CInternetSession::OnStatusCallback zurückgegeben werden.

Weitere Informationen zur GetContext Funktionsweise mit anderen WinInet-Klassen zur Angabe von Benutzerstatusinformationen finden Sie im Artikel "Internet First Steps: WinInet " für weitere Informationen zum Kontextbezeichner.

CInternet Verbinden ion::GetServerName

Rufen Sie diese Memberfunktion auf, um den Namen des Servers abzurufen, der dieser Internetverbindung zugeordnet ist.

CString GetServerName() const;

Rückgabewert

Der Name des Servers, mit dem dieses Verbindungsobjekt arbeitet.

CInternet Verbinden ion::GetSession

Rufen Sie diese Memberfunktion auf, um einen Zeiger auf das CInternetSession Objekt abzurufen, das dieser Verbindung zugeordnet ist.

CInternetSession* GetSession() const;

Rückgabewert

Ein Zeiger auf ein CInternetSession-Objekt , das diesem Internetverbindungsobjekt zugeordnet ist.

CInternet Verbinden ion::operator HINTERNET

Verwenden Sie diesen Operator, um das Handle auf API-Ebene für die aktuelle Internetsitzung abzurufen.

operator HINTERNET() const;

Siehe auch

CObject-Klasse
Hierarchiediagramm