Класс CGopherLocator

Получает gopher "locator" с сервера gopher, определяет тип указателя и делает указатель доступным для CGopherFileFind.

Примечание.

Классы CGopherConnection, CGopherFileCGopherFileFindCGopherLocator и их члены были нерекомендуемы, поскольку они не работают на платформе Windows XP, но они будут продолжать работать на более ранних платформах.

Синтаксис

class CGopherLocator : public CObject

Участники

Открытые конструкторы

Имя	Описание
CGopherLocator::CGopherLocator	Формирует объект CGopherLocator.

Открытые методы

Имя	Описание
CGopherLocator::GetLocatorType	Анализирует указатель гофера и определяет его атрибуты.

Открытые операторы

Имя	Описание
CGopherLocator::operator LPCTSTR	Непосредственно обращается к символам, хранящимся в объекте CGopherLocator в виде строки стиля C.

Замечания

Приложение должно получить указатель сервера gopher, прежде чем он сможет получить информацию с этого сервера. Получив указатель, он должен рассматривать указатель как непрозрачный маркер.

У каждого указателя gopher есть атрибуты, определяющие тип найденного файла или сервера. Список типов указателей gopher см. в разделе GetLocatorType .

Приложение обычно использует указатель для вызовов CGopherFileFind::FindFile для получения определенной части информации.

Дополнительные сведения о CGopherLocator работе с другими классами Интернета MFC см. в статье "Интернет-программирование с помощью WinInet".

Иерархия наследования

CObject

CGopherLocator

Требования

Заголовок: afxinet.h

CGopherLocator::CGopherLocator

Эта функция-член вызывается для создания CGopherLocator объекта.

CGopherLocator(const CGopherLocator& ref);

Параметры

ref;
Ссылка на постоянный CGopherLocator объект.

Замечания

Вы никогда не создаете объект напрямую CGopherLocator . Вместо этого вызовите CGopher Подключение ion::CreateLocator, чтобы создать и вернуть указатель на CGopherLocator объект.

CGopherLocator::GetLocatorType

Вызовите эту функцию-член, чтобы получить тип указателя.

BOOL GetLocatorType(DWORD& dwRef) const;

Параметры

dwRef
Ссылка на DWORD, которая получит тип указателя. См . примечания для таблицы типов указателя.

Возвращаемое значение

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Если вызов завершается ошибкой, можно вызвать функцию GetLastError Win32, чтобы определить причину ошибки.

Замечания

Возможные типы:

Значение	Значение
GOPHER_TYPE_TEXT_FILE	Текстовый файл ASCII.
GOPHER_TYPE_DIRECTORY	Каталог дополнительных элементов Gopher.
GOPHER_TYPE_CSO	Сервер телефонной книги CSO.
GOPHER_TYPE_ERROR	Указывает условие ошибки.
GOPHER_TYPE_MAC_BINHEX	Файл Macintosh в формате BINHEX.
GOPHER_TYPE_DOS_ARCHIVE	Файл архива DOS.
GOPHER_TYPE_UNIX_UUENCODED	Файл UUENCODED.
GOPHER_TYPE_INDEX_SERVER	Сервер индекса.
GOPHER_TYPE_TELNET	Сервер Telnet.
GOPHER_TYPE_BINARY	Двоичный файл.
GOPHER_TYPE_REDUNDANT	Повторяющийся сервер. Сведения, содержащиеся в ней, являются дубликатом первичного сервера. Основной сервер — это последняя запись каталога, которая не имеет типа GOPHER_TYPE_REDUNDANT.
GOPHER_TYPE_TN3270	Сервер TN3270.
GOPHER_TYPE_GIF	Графический файл GIF.
GOPHER_TYPE_IMAGE	Файл изображения.
GOPHER_TYPE_BITMAP	Файл растрового изображения.
GOPHER_TYPE_MOVIE	Файл фильма.
GOPHER_TYPE_SOUND	Звуковой файл.
GOPHER_TYPE_HTML	Документ HTML.
GOPHER_TYPE_PDF	PDF-файл.
GOPHER_TYPE_CALENDAR	Файл календаря.
GOPHER_TYPE_INLINE	Встроенный файл.
GOPHER_TYPE_UNKNOWN	Тип элемента неизвестен.
GOPHER_TYPE_ASK	Элемент Ask+.
GOPHER_TYPE_GOPHER_PLUS	Элемент Gopher+.

CGopherLocator::operator LPCTSTR

Этот полезный оператор приведения предоставляет эффективный метод для доступа к строке C, завершаемой значением NULL, содержащейся в объекте CGopherLocator .

operator LPCTSTR () const;

Возвращаемое значение

Указатель символа на данные строки.

Замечания

Символы не копируются; Возвращается только указатель.

См. также

Класс CObject
Диаграмма иерархии
Класс CGopherFileFind