CInternetConnection-Klasse
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
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 CInternetConnection
vom 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 CInternetConnection
Klassen 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für