CGopherLocator-klasse

Opmerking

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

Haalt een gopher -locator op van een gopher-server, bepaalt het type van de locator en maakt de locator beschikbaar voor CGopherFileFind.

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 CGopherLocator : public CObject

Leden

Openbare constructors

Naam	Description
CGopherLocator::CGopherLocator	Maakt een CGopherLocator object.

Openbare methoden

Naam	Description
CGopherLocator::GetLocatorType	Parseert een gopher-locator en bepaalt de kenmerken.

Openbare operators

Naam	Description
CGopherLocator::operator LPCTSTR	Rechtstreeks toegang tot tekens die zijn opgeslagen in een CGopherLocator object als een tekenreeks in C-stijl.

Opmerkingen

Een toepassing moet de locator van een gopher-server ophalen voordat deze informatie van die server kan ophalen. Zodra de locator is gebruikt, moet de locator worden behandeld als een ondoorzichtig token.

Elke gopher-locator heeft kenmerken die bepalen welk type bestand of server is gevonden. Zie GetLocatorType voor een lijst met typen gopher-locators.

Een toepassing gebruikt normaal gesproken de locator voor aanroepen naar CGopherFileFind::FindFile om een specifiek stukje informatie op te halen.

Zie het artikel Internetprogrammering met WinInet voor meer informatie over het CGopherLocator werken met de andere MFC-internetklassen.

Overnamehiërarchie

CObject

CGopherLocator

Requirements

Koptekst: afxinet.h

CGopherLocator::CGopherLocator

Deze lidfunctie wordt aangeroepen om een CGopherLocator object te maken.

CGopherLocator(const CGopherLocator& ref);

Parameterwaarden

Ref
Een verwijzing naar een constant CGopherLocator object.

Opmerkingen

U maakt nooit rechtstreeks een CGopherLocator object. Roep in plaats daarvan CGopherConnection::CreateLocator aan om een aanwijzer naar het CGopherLocator object te maken en te retourneren.

CGopherLocator::GetLocatorType

Roep deze lidfunctie aan om het locatortype op te halen.

BOOL GetLocatorType(DWORD& dwRef) const;

Parameterwaarden

dwRef
Een verwijzing naar een DWORD dat het locatortype ontvangt. Zie Opmerkingen voor een tabel met locatortypen.

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.

Opmerkingen

De mogelijke typen zijn als volgt:

Waarde	Meaning
GOPHER_TYPE_TEXT_FILE	Een ASCII-tekstbestand.
GOPHER_TYPE_DIRECTORY	Een map met extra Gopher-items.
GOPHER_TYPE_CSO	Een CSO-telefoonboekserver.
GOPHER_TYPE_ERROR	Geeft een foutvoorwaarde aan.
GOPHER_TYPE_MAC_BINHEX	Een Macintosh-bestand in BINHEX-indeling.
GOPHER_TYPE_DOS_ARCHIVE	Een DOS-archiefbestand.
GOPHER_TYPE_UNIX_UUENCODED	Een UUENCODED-bestand.
GOPHER_TYPE_INDEX_SERVER	Een indexserver.
GOPHER_TYPE_TELNET	Een Telnet-server.
GOPHER_TYPE_BINARY	Een binair bestand.
GOPHER_TYPE_REDUNDANT	Een gedupliceerde server. De informatie in die zich bevindt, is een duplicaat van de primaire server. De primaire server is de laatste mapvermelding die geen GOPHER_TYPE_REDUNDANT type heeft.
GOPHER_TYPE_TN3270	Een TN3270-server.
GOPHER_TYPE_GIF	Een GIF-afbeeldingsbestand.
GOPHER_TYPE_IMAGE	Een afbeeldingsbestand.
GOPHER_TYPE_BITMAP	Een bitmapbestand.
GOPHER_TYPE_MOVIE	Een filmbestand.
GOPHER_TYPE_SOUND	Een geluidsbestand.
GOPHER_TYPE_HTML	Een HTML-document.
GOPHER_TYPE_PDF	Een PDF-bestand.
GOPHER_TYPE_CALENDAR	Een agendabestand.
GOPHER_TYPE_INLINE	Een inlinebestand.
GOPHER_TYPE_UNKNOWN	Het itemtype is onbekend.
GOPHER_TYPE_ASK	Een Ask+-item.
GOPHER_TYPE_GOPHER_PLUS	Een Gopher+-item.

CGopherLocator::operator LPCTSTR

Deze handige cast-operator biedt een efficiënte methode voor toegang tot de tekenreeks met null-beëindigde C in een CGopherLocator object.

operator LPCTSTR () const;

Retourwaarde

Een tekenwijzer naar de gegevens van de tekenreeks.

Opmerkingen

Er worden geen tekens gekopieerd; alleen een aanwijzer wordt geretourneerd.

Zie ook

CObject-klasse
Hiërarchiegrafiek
CGopherFileFind-klasse