Megosztás a következőn keresztül:

CHttpConnection 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 a HTTP-kiszolgálóval való kapcsolatot.

Szemantika

class CHttpConnection : public CInternetConnection

Tagok

Nyilvános konstruktorok

Név Description
CHttpConnection::CHttpConnection Létrehoz egy objektumot CHttpConnection .

Nyilvános metódusok

Név Description
CHttpConnection::OpenRequest MEGnyitja a HTTP-kérést.

Megjegyzések

A HTTP az MFC WinInet-osztályok által implementált három internetkiszolgáló-protokoll egyike.

Az osztály CHttpConnection egy konstruktort és egy openRequest tagfüggvényt tartalmaz, amely HTTP-protokollal kezeli a kiszolgáló kapcsolatait.

A HTTP-kiszolgálóval való kommunikációhoz először létre kell hoznia egy CInternetSession-példányt, majd létre kell hoznia egy CHttpConnection-objektumot . Soha nem hoz létre közvetlenül objektumot CHttpConnection , ehelyett hívja meg a CInternetSession::GetHttpConnection parancsot, amely létrehozza az CHttpConnection objektumot, és egy mutatót ad vissza.

Ha többet szeretne megtudni arról, hogyan CHttpConnection működik a többi MFC internetes osztály, olvassa el az Internet Programming with WinInet című cikket. A kiszolgálókhoz a másik két támogatott internetes protokoll, a gopher és az FTP használatával való csatlakozásról a CGopherConnection és a CFtpConnection osztályban talál további információt.

Öröklési hierarchia

CObject

CInternetConnection

CHttpConnection

Requirements

Fejléc: afxinet.h

CHttpConnection::CHttpConnection

Ez a tagfüggvény egy CHttpConnection objektum létrehozásához van meghívva.

CHttpConnection(
    CInternetSession* pSession,
    HINTERNET hConnected,
    LPCTSTR pstrServer,
    DWORD_PTR dwContext);

CHttpConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL,
    DWORD_PTR dwContext = 1);

CHttpConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    DWORD dwFlags,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL,
    DWORD_PTR dwContext = 1);

Paraméterek

pSession
Egy CInternetSession objektumra mutató mutató.

hConnected
Egy internetkapcsolat leírója.

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

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

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

pstrUserName
Mutasson egy null értékű sztringre, amely megadja a bejelentkezni kívánt felhasználó nevét. Null érték esetén az alapértelmezett érték névtelen.

pstrPassword
Egy null értékű sztringre mutató mutató, amely megadja a bejelentkezéshez használni kívánt jelszót. Ha a pstrPassword és a pstrUserName is NULL értékű, az alapértelmezett névtelen jelszó a felhasználó e-mail-neve. Ha a pstrPassword NULL vagy üres sztring, de a pstrUserName nem NULL, a rendszer üres jelszót használ. Az alábbi táblázat a pstrUserName és a pstrPassword négy lehetséges beállításának viselkedését ismerteti:

pstrUserName pstrPassword FTP-kiszolgálónak küldött felhasználónév FTP-kiszolgálónak küldött jelszó
NULL vagy " " NULL vagy " " "névtelen" A felhasználó e-mail-címe
Nem NULL sztring NULL vagy " " pstrUserName " "
NULLA Nem NULL sztring ERROR ERROR
Nem NULL sztring Nem NULL sztring pstrUserName pstrPassword

dwFlags
A jelölők bármilyen kombinációja INTERNET_FLAG_* . A dwFlags értékek leírását a CHttpConnection::OpenRequestmegjegyzések szakaszában találja.

Megjegyzések

Soha nem hoz létre CHttpConnection közvetlenül. Ehelyett a CInternetSession::GetHttpConnection meghívásával hozhat létre objektumot.

CHttpConnection::OpenRequest

A tagfüggvény meghívása HTTP-kapcsolat megnyitásához.

CHttpFile* OpenRequest(
    LPCTSTR pstrVerb,
    LPCTSTR pstrObjectName,
    LPCTSTR pstrReferer = NULL,
    DWORD_PTR dwContext = 1,
    LPCTSTR* ppstrAcceptTypes = NULL,
    LPCTSTR pstrVersion = NULL,
    DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT);

CHttpFile* OpenRequest(
    int nVerb,
    LPCTSTR pstrObjectName,
    LPCTSTR pstrReferer = NULL,
    DWORD_PTR dwContext = 1,
    LPCTSTR* ppstrAcceptTypes = NULL,
    LPCTSTR pstrVersion = NULL,
    DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT);

Paraméterek

pstrVerb
A kérésben használni kívánt igét tartalmazó sztringre mutató mutató. Null érték esetén a "GET" értéket használja a rendszer.

pstrObjectName
Mutató egy sztringre, amely a megadott ige célobjektumát tartalmazza. Ez a sztring általában fájlnév, végrehajtható modul vagy keresőjelölő.

pstrReferer
Mutató egy sztringre, amely annak a dokumentumnak a címét (URL-címét) adja meg, amelyből a kérelemben szereplő URL-címet (pstrObjectName) beszerezték. Null érték esetén nincs megadva HTTP-fejléc.

dwContext
A művelet környezeti azonosítója OpenRequest . A dwContextről további információt a Megjegyzések szakaszban talál.

ppstrAcceptTypes
Az LPCTSTR null értékű tömbjéhez mutató mutató az ügyfél által elfogadott tartalomtípusokat jelző sztringekre. Ha a ppstrAcceptTypes null értékű, a kiszolgálók azt értelmezik, hogy az ügyfél csak "text/*" típusú dokumentumokat fogad el (azaz csak szöveges dokumentumokat, képeket és más bináris fájlokat nem). A tartalomtípus egyenértékű az CONTENT_TYPE CGI változóval, amely azonosítja a csatolt adatokat tartalmazó lekérdezések( például HTTP POST és PUT) adattípusát.

pstrVersion
A HTTP-verziót meghatározó sztringre mutató mutató. Null érték esetén a rendszer a "HTTP/1.0" értéket használja.

dwFlags
A INTERNET_ FLAG_* jelzők bármilyen kombinációja. A lehetséges dwFlags értékek leírását a Megjegyzések szakaszban találja.

nVerb
A HTTP-kérelem típusához társított szám. A következők egyike lehet:

HTTP-kérés típusa nVerb érték
HTTP_VERB_POST 0
HTTP_VERB_GET 1
HTTP_VERB_HEAD 2
HTTP_VERB_PUT 3
HTTP_VERB_LINK 4
HTTP_VERB_DELETE 5
HTTP_VERB_UNLINK 6

Visszaadott érték

Mutató a kért CHttpFile objektumra.

Megjegyzések

A dwFlags a következők egyike lehet:

Internetjelző Description
INTERNET_FLAG_RELOAD A kért fájl, objektum vagy könyvtárlista letöltését kényszeríti le a forráskiszolgálóról, nem pedig a gyorsítótárból.
INTERNET_FLAG_DONT_CACHE Nem adja hozzá a visszaadott entitást a gyorsítótárhoz.
INTERNET_FLAG_MAKE_PERSISTENT A visszaadott entitást állandó entitásként adja hozzá a gyorsítótárhoz. Ez azt jelenti, hogy a szabványos gyorsítótár-törlés, a konzisztencia-ellenőrzés vagy a szemétgyűjtés nem tudja eltávolítani ezt az elemet a gyorsítótárból.
INTERNET_FLAG_SECURE Biztonságos tranzakciószemantikát használ. SSL/PCT használatára fordít, és csak HTTP-kérelmekben értelmezhető
INTERNET_FLAG_NO_AUTO_REDIRECT Csak HTTP-vel használható, azt határozza meg, hogy az átirányítások nem kezelhetők automatikusan a CHttpFile::SendRequest fájlban.

Felülbírálja az dwContext alapértelmezett beállítást, ha a környezetazonosítót egy ön által választott értékre állítja. A környezetazonosító a CInternetSession objektum által létrehozott objektum adott műveletéhez CHttpConnection van társítva. A rendszer visszaadja az értéket a CInternetSession::OnStatusCallback függvénynek, hogy állapotot adjon meg azon műveleten, amellyel azonosították. A környezetazonosítóval kapcsolatos további információkért tekintse meg az internet első lépései: WinInet című cikket.

Ezzel a függvénnyel kivételeket lehet kivenni.

Lásd még

CInternetConnection osztály
hierarchiadiagram
CInternetConnection osztály
CHttpFile osztály

  • Last updated on