Udostępnij za pośrednictwem

Klasa CInternetConnection

  • Artykuł

Zarządza połączeniem z serwerem internetowym.

Składnia

class CInternetConnection : public CObject

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CInternetConnection::CInternetConnection CInternetConnection Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CInternetConnection::GetContext Pobiera identyfikator kontekstu dla tego obiektu połączenia.
CInternetConnection::GetServerName Pobiera nazwę serwera skojarzonego z połączeniem.
CInternetConnection::GetSession Pobiera wskaźnik do obiektu CInternetSession skojarzonego z połączeniem.

Operatory publiczne

Nazwa/nazwisko opis
CInternetConnection::operator HINTERNET Dojście do sesji internetowej.

Uwagi

Jest to klasa bazowa dla klas MFC CFtpConnection, CHttpConnection i CGopherConnection. Każda z tych klas zapewnia dodatkowe funkcje komunikacji z odpowiednim serwerem FTP, HTTP lub gopher.

Aby komunikować się bezpośrednio z serwerem internetowym, musisz mieć obiekt CInternetSession i CInternetConnection obiekt.

Aby dowiedzieć się więcej o sposobie działania klas WinInet, zobacz artykuł Programowanie internetowe z winInet.

Hierarchia dziedziczenia

Obiekt CObject

CInternetConnection

Wymagania

Nagłówek: afxinet.h

CInternetConnection::CInternetConnection

Ta funkcja składowa jest wywoływana CInternetConnection podczas tworzenia obiektu.

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

Parametry

PSession
Wskaźnik do obiektu CInternetSession .

pstrServer
Wskaźnik do ciągu zawierającego nazwę serwera.

nPort
Numer identyfikujący port internetowy dla tego połączenia.

dwContext
Identyfikator CInternetConnection kontekstu obiektu. Zobacz Uwagi , aby uzyskać więcej informacji na temat dwContext.

Uwagi

Nigdy nie wywołujesz CInternetConnection siebie. Zamiast tego wywołaj funkcję składową CInternetSession dla typu połączenia, które chcesz ustanowić:

Wartość domyślna obiektu dwContext jest wysyłana przez MFC do obiektu pochodnego CInternetConnectionz obiektu CInternetSession , który utworzył obiekt pochodny InternetConnection. Wartość domyślna to 1; Można jednak jawnie przypisać określony identyfikator kontekstu w konstruktorze CInternetSession dla połączenia. Obiekt i wszystkie wykonywane prace zostaną skojarzone z tym identyfikatorem kontekstu. Identyfikator kontekstu jest zwracany do CInternetSession::OnStatusCallback , aby podać stan obiektu, z którym został zidentyfikowany. Aby uzyskać więcej informacji na temat identyfikatora kontekstu, zobacz artykuł Internet First Steps: WinInet (Internet First Steps: WinInet: WinInet ).

CInternetConnection::GetContext

Wywołaj tę funkcję składową, aby uzyskać identyfikator kontekstu dla tej sesji.

DWORD_PTR GetContext() const;

Wartość zwracana

Identyfikator kontekstu przypisanego przez aplikację.

Uwagi

Identyfikator kontekstu jest pierwotnie określony w CInternetSession i propaguje do CInternetConnectionklasy - i CInternetFile pochodne, chyba że określono inaczej w wywołaniu funkcji, która otwiera połączenie. Identyfikator kontekstu jest skojarzony z dowolną operacją danego obiektu i identyfikuje informacje o stanie operacji zwrócone przez CInternetSession::OnStatusCallback.

Aby uzyskać więcej informacji o GetContext sposobie pracy z innymi klasami WinInet w celu nadania informacji o stanie użytkownika, zobacz artykuł Internet First Steps: WinInet (Pierwsze kroki: WinInet ), aby uzyskać więcej informacji na temat identyfikatora kontekstu.

CInternetConnection::GetServerName

Wywołaj tę funkcję składową, aby uzyskać nazwę serwera skojarzonego z tym połączeniem internetowym.

CString GetServerName() const;

Wartość zwracana

Nazwa serwera, z tym obiektem połączenia działa.

CInternetConnection::GetSession

Wywołaj tę funkcję składową, aby uzyskać wskaźnik do obiektu skojarzonego CInternetSession z tym połączeniem.

CInternetSession* GetSession() const;

Wartość zwracana

Wskaźnik do obiektu CInternetSession skojarzonego z tym obiektem połączenia internetowego.

CInternetConnection::operator HINTERNET

Użyj tego operatora, aby uzyskać dojście na poziomie interfejsu API dla bieżącej sesji internetowej.

operator HINTERNET() const;

Zobacz też

Klasa CObject
Wykres hierarchii