CGopherLocator-Klasse

Ruft einen Gopher "Locator" von einem Gopher-Server ab, bestimmt den Typ des Locators und macht den Locator für CGopherFileFind verfügbar.

Hinweis

Die Klassen CGopherConnection, CGopherFile, und CGopherLocator CGopherFileFindihre Member sind veraltet, da sie nicht auf der Windows XP-Plattform funktionieren, aber sie arbeiten weiterhin auf früheren Plattformen.

Syntax

class CGopherLocator : public CObject

Member

Öffentliche Konstruktoren

Name Beschreibung
CGopherLocator::CGopherLocator Erstellt ein CGopherLocator-Objekt.

Öffentliche Methoden

Name Beschreibung
CGopherLocator::GetLocatorType Analysiert einen Gopher-Locator und bestimmt seine Attribute.

Öffentliche Operatoren

Name Beschreibung
CGopherLocator::operator LPCTSTR Greift direkt auf Zeichen zu, die in einem CGopherLocator Objekt als Zeichenfolge im C-Stil gespeichert sind.

Hinweise

Eine Anwendung muss den Locator eines Gopherservers abrufen, bevor sie Informationen von diesem Server abrufen kann. Sobald er den Locator hat, muss er den Locator als undurchsichtiges Token behandeln.

Jeder Gopher-Locator verfügt über Attribute, die den Typ der gefundenen Datei oder des Servers bestimmen. Eine Liste der Typen von Gopher Locators finden Sie unter "GetLocatorType ".

Eine Anwendung verwendet normalerweise den Locator für Aufrufe von CGopherFileFind::FindFile , um eine bestimmte Informationsmenge abzurufen.

Weitere Informationen zur CGopherLocator Funktionsweise mit den anderen MFC-Internetklassen finden Sie im Artikel "Internet Programming with WinInet".

Vererbungshierarchie

CObject

CGopherLocator

Anforderungen

Kopfzeile: afxinet.h

CGopherLocator::CGopherLocator

Diese Memberfunktion wird aufgerufen, um ein CGopherLocator Objekt zu erstellen.

CGopherLocator(const CGopherLocator& ref);

Parameter

ref
Ein Verweis auf ein Konstantenobjekt CGopherLocator .

Hinweise

Sie erstellen nie direkt ein CGopherLocator Objekt. Rufen Sie stattdessen CGopherConnection::CreateLocator auf, um einen Zeiger auf das CGopherLocator Objekt zu erstellen und zurückzugeben.

CGopherLocator::GetLocatorType

Rufen Sie diese Memberfunktion auf, um den Locator-Typ abzurufen.

BOOL GetLocatorType(DWORD& dwRef) const;

Parameter

dwRef
Ein Verweis auf ein DWORD, das den Locator-Typ empfängt. Eine Tabelle mit Locator-Typen finden Sie in den Hinweisen .

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null). Wenn der Aufruf fehlschlägt, kann die Win32-Funktion GetLastError aufgerufen werden, um die Ursache des Fehlers zu ermitteln.

Hinweise

Die möglichen Typen sind wie folgt:

Wert Bedeutung
GOPHER_TYPE_TEXT_FILE Eine ASCII-Textdatei.
GOPHER_TYPE_DIRECTORY Ein Verzeichnis mit zusätzlichen Gopher-Elementen.
GOPHER_TYPE_CSO Ein CSO-Telefonbuchserver.
GOPHER_TYPE_ERROR Gibt eine Fehlerbedingung an.
GOPHER_TYPE_MAC_BINHEX Eine Macintosh-Datei im BINHEX-Format.
GOPHER_TYPE_DOS_ARCHIVE Eine DOS-Archivdatei.
GOPHER_TYPE_UNIX_UUENCODED Eine UUENCODED-Datei.
GOPHER_TYPE_INDEX_SERVER Ein Indexserver.
GOPHER_TYPE_TELNET Ein Telnet-Server.
GOPHER_TYPE_BINARY Eine Binärdatei.
GOPHER_TYPE_REDUNDANT Ein duplizierter Server. Die darin enthaltenen Informationen sind ein Duplikat des primären Servers. Der primäre Server ist der letzte Verzeichniseintrag, der keinen GOPHER_TYPE_REDUNDANT Typ aufweist.
GOPHER_TYPE_TN3270 Ein TN3270-Server.
GOPHER_TYPE_GIF Eine GIF-Grafikdatei.
GOPHER_TYPE_IMAGE Eine Bilddatei.
GOPHER_TYPE_BITMAP Eine Bitmapdatei.
GOPHER_TYPE_MOVIE Eine Filmdatei.
GOPHER_TYPE_SOUND Eine Sounddatei.
GOPHER_TYPE_HTML Ein HTML-Dokument.
GOPHER_TYPE_PDF Eine PDF-Datei.
GOPHER_TYPE_CALENDAR Eine Kalenderdatei.
GOPHER_TYPE_INLINE Eine Inlinedatei.
GOPHER_TYPE_UNKNOWN Der Elementtyp ist unbekannt.
GOPHER_TYPE_ASK Ein Ask+-Element.
GOPHER_TYPE_GOPHER_PLUS Ein Gopher+-Element.

CGopherLocator::operator LPCTSTR

Dieser nützliche Umwandlungsoperator bietet eine effiziente Methode für den Zugriff auf die in einem CGopherLocator Objekt enthaltene NULL-beendete C-Zeichenfolge.

operator LPCTSTR () const;

Rückgabewert

Ein Zeichenzeiger auf die Daten der Zeichenfolge.

Hinweise

Es werden keine Zeichen kopiert; nur ein Zeiger wird zurückgegeben.

Siehe auch

CObject-Klasse
Hierarchiediagramm
CGopherFileFind-Klasse