CInternetConnection-Klasse
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
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;