CGopherConnection 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 gopher internetkiszolgálóval való kapcsolatot.

Megjegyzés:

Az osztályok CGopherConnectionCGopherFileCGopherFileFindCGopherLocator és tagjaik elavultak, mert nem működnek a Windows XP platformon, de továbbra is a korábbi platformokon fognak működni.

Szemantika

class CGopherConnection : public CInternetConnection

Tagok

Nyilvános konstruktorok

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

Nyilvános metódusok

Név	Description
CGopherConnection::CreateLocator	Létrehoz egy CGopherLocator objektumot, amely fájlokat keres egy gopher-kiszolgálón.
CGopherConnection::GetAttribute	Lekéri a gopher objektum attribútumadatait.
CGopherConnection::OpenFile	Megnyit egy gopher-fájlt.

Megjegyzések

A gopher szolgáltatás egyike az MFC WinInet-osztályok által felismert három internetes szolgáltatásnak.

Az osztály CGopherConnection tartalmaz egy konstruktort és három további tagfüggvényt, amelyek a gopher szolgáltatást kezelik: OpenFile, CreateLocator és GetAttribute.

A gopher internetes kiszolgálóval való kommunikációhoz először létre kell hoznia egy CInternetSession-példányt, majd meghívnia a CInternetSession::GetGopherConnection parancsot, amely létrehozza az CGopherConnection objektumot, és egy mutatót ad vissza hozzá. Soha nem hozhat létre közvetlenül objektumot CGopherConnection .

Ha többet szeretne megtudni arról, hogyan CGopherConnection működik a többi MFC internetes osztály, olvassa el az Internet Programming with WinInet című cikket. A másik két támogatott internetszolgáltatás, az FTP és a HTTP használatával kapcsolatos további információkért lásd a CHttpConnection és a CFtpConnection osztályt.

Öröklési hierarchia

CObject

CInternetConnection

CGopherConnection

Requirements

Fejléc: afxinet.h

CGopherConnection::CGopherConnection

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

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

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

Paraméterek

pSession
Mutató a kapcsolódó CInternetSession objektumra.

hConnected
Az aktuális internetes munkamenet Windows-kezelője.

pstrServer
Az FTP-kiszolgáló nevét tartalmazó sztringre mutató mutató.

dwContext
A művelet környezeti azonosítója. A dwContext azonosítja a CInternetSession::OnStatusCallback által visszaadott művelet állapotadatait. Az alapértelmezett érték 1; azonban explicit módon hozzárendelhet egy adott környezeti azonosítót a művelethez. Az objektum és az általa végzett munka ehhez a környezeti azonosítóhoz lesz társítva.

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	" "
NULL nem NULL sztring	ERROR	ERROR
Nem NULL sztring	Nem NULL sztring	pstrUserName	pstrPassword

nPort
A kiszolgálón használandó TCP/IP-portot azonosító szám.

Megjegyzések

Soha nem hoz létre CGopherConnection közvetlenül. Ehelyett hívja meg a CInternetSession::GetGopherConnection parancsot, amely létrehoz egy CGopherConnection objektumot, és egy mutatót ad vissza.

CGopherConnection::CreateLocator

Hívja meg ezt a tagfüggvényt, hogy hozzon létre egy gopher-lokátort egy gopher-kiszolgálón található fájl megkereséséhez vagy azonosításához.

CGopherLocator CreateLocator(
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType);

static CGopherLocator CreateLocator(LPCTSTR pstrLocator);

static CGopherLocator CreateLocator(
    LPCTSTR pstrServerName,
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER);

Paraméterek

pstrDisplayString
A lekérendő gopher-dokumentum vagy könyvtár nevét tartalmazó sztringre mutató mutató. Ha a pstrDisplayString paraméter NULL értékű, a rendszer visszaadja a gopher-kiszolgáló alapértelmezett könyvtárát.

pstrSelectorString
A gopher-kiszolgálónak küldendő választó sztring mutatója egy elem lekéréséhez. A pstrSelectorString null értékű lehet.

dwGopherType
Ez azt határozza meg, hogy a pstrSelectorString könyvtárra vagy dokumentumra hivatkozik-e, és hogy a kérés gopher vagy gopher+-e. Tekintse meg a Windows SDK-ban GOPHER_FIND_DATA struktúra attribútumait.

pstrLocator
A megnyitni kívánt fájlt azonosító sztringre mutató mutató. Ezt a sztringet általában a CGopherFileFind::GetLocator hívása adja vissza.

pstrServerName
Mutató a gopher-kiszolgáló nevét tartalmazó sztringre.

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

Visszaadott érték

CGopherLocator objektum.

Megjegyzések

A tagfüggvény statikus verziójához meg kell adnia egy kiszolgálót, míg a nem statikus verzió a kapcsolatobjektum kiszolgálónevét használja.

Ahhoz, hogy adatokat kérhessen le egy gopher-kiszolgálóról, az alkalmazásnak először le kell szereznie egy gopher-lokátort. Az alkalmazásnak ezután átlátszatlan jogkivonatként kell kezelnie a lokátort (vagyis az alkalmazás használhatja a lokátort, de közvetlenül nem módosíthatja vagy összehasonlíthatja). Az alkalmazás általában a Lokátort használja a CGopherFileFind::FindFile tagfüggvény hívásához egy adott információ lekéréséhez.

CGopherConnection::GetAttribute

Hívja meg ezt a tagfüggvényt egy elem adott attribútumadatainak lekéréséhez a gopher-kiszolgálóról.

BOOL GetAttribute(
    CGopherLocator& refLocator,
    CString strRequestedAttributes,
    CString& strResult);

Paraméterek

refLocator
Hivatkozás egy CGopherLocator-objektumra .

strRequestedAttributes
Szóközzel tagolt sztring, amely a kért attribútumok nevét adja meg.

strResult
Hivatkozás a keresőtípust fogadó CStringre .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

CGopherConnection::OpenFile

Hívja meg ezt a tagfüggvényt, hogy nyisson meg egy fájlt egy gopher-kiszolgálón.

CGopherFile* OpenFile(
    CGopherLocator& refLocator,
    DWORD dwFlags = 0,
    LPCTSTR pstrView = NULL,
    DWORD_PTR dwContext = 1);

Paraméterek

refLocator
Hivatkozás egy CGopherLocator-objektumra .

dwFlags
A INTERNET_FLAG_* jelzők bármilyen kombinációja. A INTERNET_FLAG_* jelzőkkel kapcsolatos további információkért lásd : CInternetSession::OpenUrl .

pstrView
Mutató egy fájlnézeti sztringre. Ha a fájlnak több nézete is van a kiszolgálón, ez a paraméter határozza meg a megnyitni kívánt fájlnézetet. Ha a pstrView NULL értékű, a rendszer az alapértelmezett fájlnézetet használja.

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

Visszaadott érték

A megnyitni kívánt CGopherFile objektumra mutató mutató.

Megjegyzések

Felülbírálja a dwContext alapértelmezett értékét, hogy a környezetazonosítót az Ön által választott értékre állítsa. A környezetazonosító a CInternetSession objektum által létrehozott objektum adott műveletéhez CGopherConnection 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í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.

Lásd még

CInternetConnection osztály
hierarchiadiagram
CFtpConnection osztály
CHttpConnection osztály
CInternetConnection osztály
CGopherLocator osztály
CGopherFile osztály
CInternetSession osztály