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
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.