CInternetConnection-Klasse

  • Artikel

Verwaltet die Verbindung mit einem Internetserver.

Syntax

class CInternetConnection : public CObject

Member

Öffentliche Konstruktoren

Name Beschreibung
CInternetConnection::CInternetConnection Erstellt ein CInternetConnection-Objekt.

Öffentliche Methoden

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

Öffentliche Operatoren

Name Beschreibung
CInternetConnection::operator HINTERNET Ein Handle für eine Internetsitzung.

Hinweise

Es ist die Basisklasse für die MFC-Klassen CFtpConnection, CHttpConnection und CGopherConnection. 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

CInternetConnection::CInternetConnection

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 von InternetConnection 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 alle Arbeiten, die es ausführt, werden mit dieser Kontext-ID verknüpft. 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 ".

CInternetConnection::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.

CInternetConnection::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.

CInternetConnection::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.

CInternetConnection::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