CGopherConnection-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Beheert uw verbinding met een gopher-internetserver.

Opmerking

De klassenCGopherConnection, CGopherFileen CGopherFileFindCGopherLocator hun leden zijn afgeschaft omdat ze niet werken op het Windows XP-platform, maar ze blijven werken op eerdere platforms.

Syntaxis

class CGopherConnection : public CInternetConnection

Leden

Openbare constructors

Naam	Description
CGopherConnection::CGopherConnection	Maakt een CGopherConnection object.

Openbare methoden

Naam	Description
CGopherConnection::CreateLocator	Hiermee maakt u een CGopherLocator-object om bestanden op een gopher-server te zoeken.
CGopherConnection::GetAttribute	Haalt kenmerkinformatie over het gopher-object op.
CGopherConnection::OpenFile	Hiermee opent u een gopher-bestand.

Opmerkingen

De gopher-service is een van de drie internetservices die worden herkend door de MFC WinInet-klassen.

De klasse CGopherConnection bevat een constructor en drie extra lidfuncties waarmee de gopher-service wordt beheerd: OpenFile, CreateLocator en GetAttribute.

Als u wilt communiceren met een gopher-internetserver, moet u eerst een exemplaar van CInternetSession maken en vervolgens CInternetSession aanroepen::GetGopherConnection, waarmee het CGopherConnection object wordt gemaakt en er een aanwijzer naar wordt geretourneerd. U maakt nooit rechtstreeks een CGopherConnection object.

Zie het artikel Internetprogrammering met WinInet voor meer informatie over het CGopherConnection werken met de andere MFC-internetklassen. Zie de klassen CHttpConnection en CFtpConnection voor meer informatie over het gebruik van de andere twee ondersteunde internetservices, FTP en HTTP.

Overnamehiërarchie

CObject

CInternetConnection

CGopherConnection

Requirements

Koptekst: afxinet.h

CGopherConnection::CGopherConnection

Deze lidfunctie wordt aangeroepen om een CGopherConnection object te maken.

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

Parameterwaarden

pSession
Een aanwijzer naar het gerelateerde CInternetSession-object .

hConnected
De Windows-ingang van de huidige internetsessie.

pstrServer
Een aanwijzer naar een tekenreeks met de naam van de FTP-server.

dwContext
De context-id voor de bewerking. dwContext identificeert de statusinformatie van de bewerking die wordt geretourneerd door CInternetSession::OnStatusCallback. De standaardwaarde is ingesteld op 1; U kunt echter expliciet een specifieke context-id toewijzen voor de bewerking. Het object en alle werkzaamheden die het doet, worden gekoppeld aan die context-id.

pstrUserName
Aanwijzer naar een door null beëindigde tekenreeks waarmee de naam van de gebruiker wordt opgegeven die moet worden aangemeld. Als NULL is, is de standaardwaarde anoniem.

pstrPassword
Een aanwijzer naar een door null beëindigde tekenreeks waarmee het wachtwoord wordt opgegeven dat moet worden gebruikt om u aan te melden. Als zowel pstrPassword als pstrUserName NULL zijn, is het standaard anonieme wachtwoord de e-mailadresnaam van de gebruiker. Als pstrPassword NULL (of een lege tekenreeks) is, maar pstrUserName niet NULL is, wordt een leeg wachtwoord gebruikt. In de volgende tabel wordt het gedrag beschreven voor de vier mogelijke instellingen van pstrUserName en pstrPassword:

pstrUserName	pstrPassword	Gebruikersnaam verzonden naar FTP-server	Wachtwoord verzonden naar FTP-server
NULL of " "	NULL of " "	"anoniem"	E-mailnaam van gebruiker
Niet-NULL-tekenreeks	NULL of " "	pstrUserName	" "
NULL-tekenreeks die niet null is	ERROR	ERROR
Niet-NULL-tekenreeks	Niet-NULL-tekenreeks	pstrUserName	pstrPassword

nPort
Een getal dat de TCP/IP-poort identificeert die op de server moet worden gebruikt.

Opmerkingen

U maakt nooit rechtstreeks een CGopherConnection . Roep in plaats daarvan CInternetSession::GetGopherConnection aan, waarmee een CGopherConnection object wordt gemaakt en er een aanwijzer naar wordt geretourneerd.

CGopherConnection::CreateLocator

Roep deze lidfunctie aan om een gopher-locator te maken om een bestand op een gopher-server te zoeken of te identificeren.

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

Parameterwaarden

pstrDisplayString
Een aanwijzer naar een tekenreeks met de naam van het gopher-document of de map die moet worden opgehaald. Als de parameter pstrDisplayString NULL is, wordt de standaardmap voor de gopher-server geretourneerd.

pstrSelectorString
Een aanwijzer naar de selectortekenreeks die naar de gopher-server moet worden verzonden om een item op te halen. pstrSelectorString kan NULL zijn.

dwGopherType
Hiermee geeft u op of pstrSelectorString verwijst naar een map of document en of de aanvraag gopher of gopher+ is. Bekijk de kenmerken voor de structuur GOPHER_FIND_DATA in de Windows SDK.

pstrLocator
Een aanwijzer naar een tekenreeks die het bestand identificeert dat moet worden geopend. Over het algemeen wordt deze tekenreeks geretourneerd vanuit een aanroep naar CGopherFileFind::GetLocator.

pstrServerName
Een aanwijzer naar een tekenreeks met de naam van de gopher-server.

nPort
Het nummer waarmee de internetpoort voor deze verbinding wordt geïdentificeerd.

Retourwaarde

Een CGopherLocator-object .

Opmerkingen

Voor de statische versie van de lidfunctie moet u een server opgeven, terwijl de niet-statische versie de servernaam van het verbindingsobject gebruikt.

Als u informatie wilt ophalen van een gopher-server, moet een toepassing eerst een gopher-locator ophalen. De toepassing moet de locator vervolgens behandelen als een ondoorzichtig token (de toepassing kan de locator gebruiken, maar niet rechtstreeks bewerken of vergelijken). Normaal gesproken gebruikt de toepassing de locator voor aanroepen naar de CGopherFileFind::FindFile-lidfunctie om een specifiek stukje informatie op te halen.

CGopherConnection::GetAttribute

Roep deze lidfunctie aan om specifieke kenmerkinformatie over een item op te halen van de gopher-server.

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

Parameterwaarden

refLocator
Een verwijzing naar een CGopherLocator-object .

strRequestedAttributes
Een tekenreeks met spatiescheiding die de namen van de aangevraagde kenmerken aangeeft.

Strresult
Een verwijzing naar een CString die het type locator ontvangt.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

CGopherConnection::OpenFile

Roep deze lidfunctie aan om een bestand op een gopher-server te openen.

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

Parameterwaarden

refLocator
Een verwijzing naar een CGopherLocator-object .

dwFlags
Elke combinatie van INTERNET_FLAG_* vlaggen. Zie CInternetSession::OpenUrl voor meer informatie over INTERNET_FLAG_* vlaggen.

pstrView
Een aanwijzer naar een tekenreeks voor bestandsweergave. Als er verschillende weergaven van het bestand op de server bestaan, geeft deze parameter aan welke bestandsweergave moet worden geopend. Als pstrView NULL is, wordt de standaardbestandsweergave gebruikt.

dwContext
De context-id voor het bestand dat wordt geopend. Zie Opmerkingen voor meer informatie over dwContext.

Retourwaarde

Een aanwijzer naar het CGopherFile-object dat moet worden geopend.

Opmerkingen

Overschrijf de dwContext-standaardinstelling om de context-id in te stellen op een waarde van uw keuze. De context-id is gekoppeld aan deze specifieke bewerking van het object dat is gemaakt door het CGopherConnectionCInternetSession-object . De waarde wordt geretourneerd naar CInternetSession::OnStatusCallback om de status op te geven van de bewerking waarmee deze wordt geïdentificeerd. Zie het artikel Internet First Steps: WinInet voor meer informatie over de context-id.

Zie ook

CInternetConnection-klasse
Hiërarchiegrafiek
CFtpConnection-klasse
CHttpConnection-klasse
CInternetConnection-klasse
CGopherLocator-klasse
CGopherFile-klasse
CInternetSession-klasse