Klasa CGopherLocator

Pobiera "lokalizator" gopher z serwera gopher, określa typ lokalizatora i udostępnia lokalizatorowi CGopherFileFind.

Uwaga

Klasy CGopherConnection, CGopherFile, CGopherFileFindCGopherLocator i ich składowe zostały przestarzałe, ponieważ nie działają na platformie Windows XP, ale będą nadal działać na wcześniejszych platformach.

Składnia

class CGopherLocator : public CObject

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CGopherLocator::CGopherLocator	CGopherLocator Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CGopherLocator::GetLocatorType	Analizuje lokalizator gopher i określa jego atrybuty.

Operatory publiczne

Nazwa/nazwisko	opis
CGopherLocator::operator LPCTSTR	Bezpośrednio uzyskuje dostęp do znaków przechowywanych w CGopherLocator obiekcie jako ciągu w stylu C.

Uwagi

Aplikacja musi uzyskać lokalizator serwera gopher, zanim będzie mogła pobrać informacje z tego serwera. Po utworzeniu lokalizatora musi traktować lokalizator jako nieprzezroczystym tokenem.

Każdy lokalizator gopher ma atrybuty, które określają typ znalezionego pliku lub serwera. Zobacz GetLocatorType , aby uzyskać listę typów lokalizatorów szyfrowania.

Aplikacja zwykle używa lokalizatora do wywołań funkcji CGopherFileFind::FindFile w celu pobrania określonego elementu informacji.

Aby dowiedzieć się więcej o CGopherLocator sposobie pracy z innymi klasami internetowymi MFC, zobacz artykuł Programowanie internetowe za pomocą usługi WinInet.

Hierarchia dziedziczenia

Obiekt CObject

CGopherLocator

Wymagania

Nagłówek: afxinet.h

CGopherLocator::CGopherLocator

Ta funkcja składowa jest wywoływana w celu utworzenia CGopherLocator obiektu.

CGopherLocator(const CGopherLocator& ref);

Parametry

ref
Odwołanie do obiektu stałej CGopherLocator .

Uwagi

Nigdy nie tworzysz CGopherLocator obiektu bezpośrednio. Zamiast tego wywołaj metodę CGopherConnection::CreateLocator , aby utworzyć i zwrócić wskaźnik do CGopherLocator obiektu.

CGopherLocator::GetLocatorType

Wywołaj tę funkcję składową, aby uzyskać typ lokalizatora.

BOOL GetLocatorType(DWORD& dwRef) const;

Parametry

dwRef
Odwołanie do DWORD, które otrzyma typ lokalizatora. Zobacz Uwagi dotyczące tabeli typów lokalizatorów.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

Możliwe typy są następujące:

Wartość	Znaczenie
GOPHER_TYPE_TEXT_FILE	Plik tekstowy ASCII.
GOPHER_TYPE_DIRECTORY	Katalog dodatkowych elementów języka Gopher.
GOPHER_TYPE_CSO	Serwer książki telefonicznej CSO.
GOPHER_TYPE_ERROR	Wskazuje warunek błędu.
GOPHER_TYPE_MAC_BINHEX	Plik Macintosh w formacie BINHEX.
GOPHER_TYPE_DOS_ARCHIVE	Plik archiwum systemu DOS.
GOPHER_TYPE_UNIX_UUENCODED	Plik UUENCODED.
GOPHER_TYPE_INDEX_SERVER	Serwer indeksowania.
GOPHER_TYPE_TELNET	Serwer Telnet.
GOPHER_TYPE_BINARY	Plik binarny.
GOPHER_TYPE_REDUNDANT	Zduplikowany serwer. Informacje zawarte w programie są duplikatem serwera podstawowego. Serwer podstawowy jest ostatnim wpisem katalogu, który nie miał typu GOPHER_TYPE_REDUNDANT.
GOPHER_TYPE_TN3270	Serwer TN3270.
GOPHER_TYPE_GIF	Plik graficzny GIF.
GOPHER_TYPE_IMAGE	Plik obrazu.
GOPHER_TYPE_BITMAP	Plik mapy bitowej.
GOPHER_TYPE_MOVIE	Plik filmu.
GOPHER_TYPE_SOUND	Plik dźwiękowy.
GOPHER_TYPE_HTML	Dokument HTML.
GOPHER_TYPE_PDF	Plik PDF.
GOPHER_TYPE_CALENDAR	Plik kalendarza.
GOPHER_TYPE_INLINE	Wbudowany plik.
GOPHER_TYPE_UNKNOWN	Typ elementu jest nieznany.
GOPHER_TYPE_ASK	Element Ask+.
GOPHER_TYPE_GOPHER_PLUS	Element Gopher+.

CGopherLocator::operator LPCTSTR

Ten przydatny operator rzutowania zapewnia wydajną metodę uzyskiwania dostępu do ciągu C zakończonego wartością null zawartego CGopherLocator w obiekcie.

operator LPCTSTR () const;

Wartość zwracana

Wskaźnik znaku do danych ciągu.

Uwagi

Nie są kopiowane żadne znaki; zwracany jest tylko wskaźnik.

Zobacz też

Klasa CObject
Wykres hierarchii
Klasa CGopherFileFind