CInternetConnection osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Kezeli az internetkiszolgálóval való kapcsolatot.

Szemantika

class CInternetConnection : public CObject

Tagok

Nyilvános konstruktorok

Név	Description
CInternetConnection::CInternetConnection	Egy CInternetConnection objektumot hoz létre.

Nyilvános metódusok

Név	Description
CInternetConnection::GetContext	Lekéri a kapcsolatobjektum környezeti azonosítóját.
CInternetConnection::GetServerName	Lekéri a kapcsolathoz társított kiszolgáló nevét.
CInternetConnection::GetSession	A kapcsolathoz társított CInternetSession objektumra mutató mutatót kap.

Nyilvános operátorok

Név	Description
CInternetConnection::operátor HINTERNET	Egy internetes munkamenet leírója.

Megjegyzések

Ez a CFtpConnection, CHttpConnection és CGopherConnection MFC-osztályok alaposztálya. Ezek az osztályok további funkciókat biztosítanak a megfelelő FTP-, HTTP- vagy gopher-kiszolgálóval való kommunikációhoz.

Ahhoz, hogy közvetlenül kommunikáljon egy internetes kiszolgálóval, rendelkeznie kell egy CInternetSession objektummal és egy objektummal CInternetConnection .

Ha többet szeretne megtudni a WinInet-osztályok működéséről, olvassa el az Internet Programozás a WinInettel című cikket.

Öröklési hierarchia

CObject

CInternetConnection

Requirements

Fejléc: afxinet.h

CInternetConnection::CInternetConnection

Ez a tagfüggvény egy CInternetConnection objektum létrehozásakor lesz meghívva.

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

Paraméterek

pSession
Egy CInternetSession objektumra mutató mutató.

pstrServer
A kiszolgáló nevét tartalmazó sztringre mutató mutató.

nPort
A kapcsolathoz tartozó internetes portot azonosító szám.

dwContext
Az objektum környezeti azonosítója CInternetConnection . A dwContextről további információt a Megjegyzések című témakörben talál.

Megjegyzések

Soha nem hívhatja CInternetConnection meg magát; ehelyett hívja meg a CInternetSession tagfüggvényt a létesítendő kapcsolat típusához:

• CInternetSession::GetFtpConnection

• CInternetSession::GetHttpConnection

• CInternetSession::GetGopherConnection

A dwContext alapértelmezett értékét az MFC küldi el az CInternetConnectionInternetConnection-származtatott objektumot létrehozó CInternetSession objektumból származó -származtatott objektumnak. Az alapértelmezett érték 1; azonban explicit módon hozzárendelhet egy adott környezeti azonosítót a CInternetSession konstruktorhoz a kapcsolathoz. Az objektum és az általa végzett munka ehhez a környezeti azonosítóhoz lesz társítva. A rendszer visszaadja a környezetazonosítót a CInternetSession::OnStatusCallback fájlnak, hogy állapotot adjon meg azon az objektumon, amellyel azonosítva van. A környezetazonosítóval kapcsolatos további információkért tekintse meg az internet első lépései: WinInet című cikket.

CInternetConnection::GetContext

Hívja meg ezt a tagfüggvényt a munkamenet környezeti azonosítójának lekéréséhez.

DWORD_PTR GetContext() const;

Visszaadott érték

Az alkalmazás által hozzárendelt környezetazonosító.

Megjegyzések

A környezetazonosító eredetileg a CInternetSessionban van megadva, és - és CInternetFile-származtatott osztályokba CInternetConnectionpropagálja, kivéve, ha másként van megadva a kapcsolatot megnyitó függvény hívásában. A környezeti azonosító az adott objektum bármely műveletéhez van társítva, és azonosítja a CInternetSession::OnStatusCallback által visszaadott állapotinformációkat.

Ha többet szeretne tudni arról, hogyan GetContext működik a többi WinInet-osztály a felhasználói állapottal kapcsolatos információk megadásához, olvassa el az Internet Első lépések: WinInet című cikket a környezetazonosítóval kapcsolatos további információkért.

CInternetConnection::GetServerName

Hívja meg ezt a tagfüggvényt az internetkapcsolathoz társított kiszolgáló nevének lekéréséhez.

CString GetServerName() const;

Visszaadott érték

Annak a kiszolgálónak a neve, amellyel a kapcsolati objektum működik.

CInternetConnection::GetSession

Hívja meg ezt a tagfüggvényt a kapcsolathoz társított objektum mutatójának CInternetSession lekéréséhez.

CInternetSession* GetSession() const;

Visszaadott érték

Az internetkapcsolat objektumához társított CInternetSession objektumra mutató mutató.

CInternetConnection::operátor HINTERNET

Ezzel az operátorral lekérheti az aktuális internetes munkamenetHEZ tartozó API-szintű leírót.

operator HINTERNET() const;

Lásd még

CObject osztály
hierarchiadiagram