CGopherConnection – třída

Spravuje připojení k internetovému serveru gopher.

Poznámka:

Třídy CGopherConnection, CGopherFilea CGopherFileFindCGopherLocator jejich členové jsou zastaralé, protože nefungují na platformě Windows XP, ale budou nadále pracovat na dřívějších platformách.

Syntaxe

class CGopherConnection : public CInternetConnection

Členové

Veřejné konstruktory

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

Veřejné metody

Název	Popis
CGopherConnection::CreateLocator	Vytvoří objekt CGopherLocator pro vyhledání souborů na serveru gopher.
CGopherConnection::GetAttribute	Načte informace o atributu objektu gopher.
CGopherConnection::OpenFile	Otevře soubor gopher.

Poznámky

Gopher je jedna ze tří internetových služeb rozpoznaných třídami PROSTŘEDÍ WINInet MFC.

Třída CGopherConnection obsahuje konstruktor a tři další členské funkce, které spravují gopher služby: OpenFile, CreateLocator a GetAttribute.

Pokud chcete komunikovat s internetovým serverem gopher, musíte nejprve vytvořit instanci CInternetSession a potom volat CInternetSession::GetGopherConnection, která vytvoří CGopherConnection objekt a vrátí ukazatel na něj. Nikdy nevytvoříte CGopherConnection objekt přímo.

Další informace o tom, jak CGopherConnection funguje s ostatními internetovými třídami MFC, najdete v článku Internetové programování pomocí winInetu. Další informace o použití dalších dvou podporovaných internetových služeb, FTP a HTTP naleznete třídy CHttpConnection a CFtpConnection.

Hierarchie dědičnosti

Objekt CObject

CInternetConnection

CGopherConnection

Požadavky

Hlavička: afxinet.h

CGopherConnection::CGopherConnection

Tato členová funkce je volána k vytvoření objektu CGopherConnection .

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);

Parametry

PSession
Ukazatel na související objekt CInternetSession .

hConnected
Popisovač Windows aktuální internetové relace.

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

dwContext
Identifikátor kontextu operace. dwContext identifikuje informace o stavu operace vrácené CInternetSession::OnStatusCallback. Výchozí hodnota je nastavená na hodnotu 1; Pro operaci však můžete explicitně přiřadit konkrétní ID kontextu. Objekt a jakákoli práce, kterou provede, se přidružuje k danému ID kontextu.

pstrUserName
Ukazatel na řetězec ukončený hodnotou null, který určuje jméno uživatele, který se má přihlásit. Pokud má hodnotu NULL, výchozí hodnota je anonymní.

pstrPassword
Ukazatel na řetězec ukončený hodnotou null, který určuje heslo, které se má použít pro přihlášení. Pokud jsou hodnoty pstrPassword i pstrUserName null, výchozí anonymní heslo je e-mailové jméno uživatele. Pokud je pstrPassword NULL (nebo prázdný řetězec), ale pstrUserName není NULL, použije se prázdné heslo. Následující tabulka popisuje chování čtyř možných nastavení pstrUserName a pstrPassword:

pstrUserName	pstrPassword	Uživatelské jméno odeslané na server FTP	Heslo odeslané na server FTP
NULL nebo "	NULL nebo "	"anonymní"	E-mailové jméno uživatele
Řetězec bez hodnoty NULL	NULL nebo "	pstrUserName	" "
Řetězec null bez hodnoty NULL	CHYBA	CHYBA
Řetězec bez hodnoty NULL	Řetězec bez hodnoty NULL	pstrUserName	pstrPassword

nPort
Číslo, které identifikuje port TCP/IP, který se má použít na serveru.

Poznámky

Nikdy nevytvoříte CGopherConnection přímo. Místo toho zavolejte CInternetSession::GetGopherConnection, který vytvoří CGopherConnection objekt a vrátí ukazatel na něj.

CGopherConnection::CreateLocator

Voláním této členské funkce vytvořte lokátor gopher k vyhledání nebo identifikaci souboru na serveru gopher.

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);

Parametry

pstrDisplayString
Ukazatel na řetězec obsahující název dokumentu gopher nebo adresáře, který se má načíst. Pokud je parametr pstrDisplayString NULL, vrátí se výchozí adresář pro server gopher.

pstrSelectorString
Ukazatel na řetězec selektoru, který se má odeslat na server gopher, aby se načetla položka. pstrSelectorString může mít hodnotu NULL.

dwGopherType
Určuje, jestli pstrSelectorString odkazuje na adresář nebo dokument a zda je požadavek gopher nebo gopher+. Viz atributy struktury GOPHER_FIND_DATA v sadě Windows SDK.

pstrLocator
Ukazatel na řetězec identifikující soubor, který se má otevřít. Obecně platí, že tento řetězec je vrácen z volání CGopherFileFind::GetLocator.

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

nPort
Číslo identifikující internetový port pro toto připojení.

Návratová hodnota

Objekt CGopherLocator .

Poznámky

Statická verze členské funkce vyžaduje, abyste zadali server, zatímco nestatická verze používá název serveru z objektu připojení.

Aby bylo možné načíst informace ze serveru gopher, musí aplikace nejprve získat lokátor gopher. Aplikace pak musí s lokátorem zacházet jako s neprůhleným tokenem (to znamená, že aplikace může použít lokátor, ale ne přímo manipulovat ani jej porovnat). Za normálních okolností aplikace používá lokátor pro volání CGopherFileFind::FindFile členské funkce k načtení konkrétní části informací.

CGopherConnection::GetAttribute

Voláním této členské funkce načtěte informace o konkrétních atributech o položce ze serveru gopher.

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

Parametry

refLocator
Odkaz na objekt CGopherLocator .

strRequestedAttributes
Řetězec oddělený mezerami určující názvy požadovaných atributů.

strResult
Odkaz na řetězec CString , který obdrží typ lokátoru.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0. Pokud volání selže, může být volána funkce Win32 GetLastError k určení příčiny chyby.

CGopherConnection::OpenFile

Voláním této členské funkce otevřete soubor na serveru gopher.

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

Parametry

refLocator
Odkaz na objekt CGopherLocator .

dwFlags
Libovolná kombinace příznaků INTERNET_FLAG_*. Další informace o příznakech INTERNET_FLAG_* najdete v tématu CInternetSession::OpenUrl.

pstrView
Ukazatel na řetězec zobrazení souboru. Pokud na serveru existuje několik zobrazení souboru, určuje tento parametr, které se má otevřít. Pokud je pstrView NULL, použije se výchozí zobrazení souborů.

dwContext
ID kontextu pro soubor, který se otevírá. Další informace o dwContext naleznete v části Poznámky.

Návratová hodnota

Ukazatel na objekt CGopherFile , který se má otevřít.

Poznámky

Přepište výchozí hodnotu dwContext a nastavte identifikátor kontextu na hodnotu podle vašeho výběru. Identifikátor kontextu je přidružen k této konkrétní operaci objektu CGopherConnection vytvořeného jeho CInternetSession objektu. Hodnota je vrácena do CInternetSession::OnStatusCallback poskytnout stav operace, se kterou je identifikován. Další informace o identifikátoru kontextu najdete v článku Internet First Steps: WinInet .

Viz také

CInternetConnection – třída
Graf hierarchie
CFtpConnection – třída
CHttpConnection – třída
CInternetConnection – třída
CGopherLocator – třída
CGopherFile – třída
CInternetSession – třída