Sdílet prostřednictvím

CInternetConnection – třída

  • Článek

Spravuje připojení k internetovému serveru.

Syntaxe

class CInternetConnection : public CObject

Členové

Veřejné konstruktory

Název Popis
CInternetConnection::CInternetConnection CInternetConnection Vytvoří objekt.

Veřejné metody

Název Popis
CInternetConnection::GetContext Získá ID kontextu pro tento objekt připojení.
CInternetConnection::GetServerName Získá název serveru přidruženého k připojení.
CInternetConnection::GetSession Získá ukazatel na CInternetSession objekt přidružený k připojení.

Veřejné operátory

Název Popis
CInternetConnection::operator HINTERNET Popisovač internetové relace.

Poznámky

Je to základní třída pro mfc třídy CFtpConnection, CHttpConnection a CGopherConnection. Každá z těchto tříd poskytuje další funkce pro komunikaci s příslušným serverem FTP, HTTP nebo gopher.

Pokud chcete komunikovat přímo s internetovým serverem, musíte mít objekt CInternetSession a CInternetConnection objekt.

Další informace o tom, jak třídy WinInet fungují, najdete v článku O programování internetu pomocí WinInet.

Hierarchie dědičnosti

Objekt CObject

CInternetConnection

Požadavky

Hlavička: afxinet.h

CInternetConnection::CInternetConnection

Tato členová funkce je volána při vytvoření objektu CInternetConnection .

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

Parametry

PSession
Ukazatel na objekt CInternetSession .

pstrServer
Ukazatel na řetězec obsahující název serveru.

nPort
Číslo, které identifikuje internetový port pro toto připojení.

dwContext
Identifikátor kontextu objektu CInternetConnection . Další informace o dwContext naleznete v části Poznámky.

Poznámky

Nikdy nevoláte CInternetConnection sami. Místo toho volejte členovu funkci CInternetSession pro typ připojení, které chcete navázat:

Výchozí hodnota dwContext je odeslána mfc CInternetConnection-odvozený objekt z CInternetSession objekt, který vytvořil InternetConnection odvozený objekt. Výchozí hodnota je nastavená na hodnotu 1; Můžete však explicitně přiřadit konkrétní kontext identifikátor v CInternetSession konstruktor pro připojení. Objekt a jakákoli práce, kterou provede, se přidružuje k danému ID kontextu. Identifikátor kontextu je vrácen do CInternetSession::OnStatusCallback poskytnout stav objektu, se kterým je identifikován. Další informace o identifikátoru kontextu najdete v článku Internet First Steps: WinInet .

CInternetConnection::GetContext

Voláním této členské funkce získáte ID kontextu pro tuto relaci.

DWORD_PTR GetContext() const;

Návratová hodnota

ID kontextu přiřazeného aplikací.

Poznámky

ID kontextu je původně zadáno v CInternetSession a šíří do CInternetConnection- a CInternetFile-odvozené třídy, pokud není zadán jinak ve volání funkce, která otevře připojení. ID kontextu je přidruženo k jakékoli operaci daného objektu a identifikuje informace o stavu operace vrácené CInternetSession::OnStatusCallback.

Další informace o tom, jak GetContext funguje s jinými třídami WinInet poskytnout informace o stavu uživatele, naleznete v článku Internet First Steps: WinInet další informace o identifikátoru kontextu.

CInternetConnection::GetServerName

Voláním této členské funkce získáte název serveru přidruženého k tomuto připojení k internetu.

CString GetServerName() const;

Návratová hodnota

Název serveru, se kterým tento objekt připojení pracuje.

CInternetConnection::GetSession

Voláním této členské funkce získáte ukazatel na CInternetSession objekt přidružený k tomuto připojení.

CInternetSession* GetSession() const;

Návratová hodnota

Ukazatel na objekt CInternetSession přidružený k tomuto objektu připojení k internetu.

CInternetConnection::operator HINTERNET

Tento operátor slouží k získání popisovače na úrovni rozhraní API pro aktuální internetovou relaci.

operator HINTERNET() const;

Viz také

CObject – třída
Graf hierarchie