Share via

CInternetConnection-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Beheert uw verbinding met een internetserver.

Syntaxis

class CInternetConnection : public CObject

Leden

Openbare constructors

Naam Description
CInternetConnection::CInternetConnection Maakt een CInternetConnection object.

Openbare methoden

Naam Description
CInternetConnection::GetContext Hiermee haalt u de context-id voor dit verbindingsobject op.
CInternetConnection::GetServerName Hiermee haalt u de naam op van de server die is gekoppeld aan de verbinding.
CInternetConnection::GetSession Hiermee wordt een aanwijzer opgehaald naar het CInternetSession-object dat aan de verbinding is gekoppeld.

Openbare operators

Naam Description
CInternetConnection::operator ACHTERNET Een ingang voor een internetsessie.

Opmerkingen

Het is de basisklasse voor MFC-klassen CFtpConnection, CHttpConnection en CGopherConnection. Elk van deze klassen biedt extra functionaliteit voor communicatie met de respectieve FTP-, HTTP- of gopher-server.

Als u rechtstreeks met een internetserver wilt communiceren, moet u een CInternetSession-object en een CInternetConnection object hebben.

Zie het artikel Internetprogrammering met WinInet voor meer informatie over hoe de WinInet-klassen werken.

Overnamehiërarchie

CObject

CInternetConnection

Requirements

Koptekst: afxinet.h

CInternetConnection::CInternetConnection

Deze lidfunctie wordt aangeroepen wanneer een CInternetConnection object wordt gemaakt.

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

Parameterwaarden

pSession
Een aanwijzer naar een CInternetSession-object .

pstrServer
Een aanwijzer naar een tekenreeks met de servernaam.

nPort
Het nummer waarmee de internetverbinding voor deze verbinding wordt geïdentificeerd.

dwContext
De context-id voor het CInternetConnection object. Zie Opmerkingen voor meer informatie over dwContext.

Opmerkingen

U roept CInternetConnection uzelf nooit aan. Roep in plaats daarvan de CInternetSession-lidfunctie aan voor het type verbinding dat u tot stand wilt brengen:

De standaardwaarde voor dwContext wordt door MFC verzonden naar het CInternetConnection-afgeleide object van het CInternetSession-object dat het door InternetConnection afgeleide object heeft gemaakt. De standaardwaarde is ingesteld op 1; U kunt echter expliciet een specifieke context-id toewijzen in de CInternetSession-constructor voor de verbinding. Het object en alle werkzaamheden die het doet, worden gekoppeld aan die context-id. De context-id wordt geretourneerd naar CInternetSession::OnStatusCallback om de status op te geven van het object waarmee het wordt geïdentificeerd. Zie het artikel Internet First Steps: WinInet voor meer informatie over de context-id.

CInternetConnection::GetContext

Roep deze lidfunctie aan om de context-id voor deze sessie op te halen.

DWORD_PTR GetContext() const;

Retourwaarde

De door de toepassing toegewezen context-id.

Opmerkingen

De context-id is oorspronkelijk opgegeven in CInternetSession en wordt doorgegeven aan CInternetConnection- en CInternetFile-afgeleide klassen, tenzij anders is opgegeven in de aanroep naar een functie waarmee de verbinding wordt geopend. De context-id is gekoppeld aan elke bewerking van het opgegeven object en identificeert de statusinformatie van de bewerking die wordt geretourneerd door CInternetSession::OnStatusCallback.

Zie het artikel Internet First Steps: WinInet voor meer informatie over het GetContext werken met andere WinInet-klassen om de gebruikersstatusinformatie te geven.

CInternetConnection::GetServerName

Roep deze lidfunctie aan om de naam op te halen van de server die is gekoppeld aan deze internetverbinding.

CString GetServerName() const;

Retourwaarde

De naam van de server waarmee dit verbindingsobject werkt.

CInternetConnection::GetSession

Roep deze lidfunctie aan om een aanwijzer op te halen naar het CInternetSession object dat aan deze verbinding is gekoppeld.

CInternetSession* GetSession() const;

Retourwaarde

Een aanwijzer naar een CInternetSession-object dat is gekoppeld aan dit internetverbindingsobject.

CInternetConnection::operator ACHTERNET

Gebruik deze operator om de ingang op API-niveau op te halen voor de huidige internetsessie.

operator HINTERNET() const;

Zie ook

CObject-klasse
Hiërarchiegrafiek

  • Last updated on