Класс 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".
Иерархия наследования
CGopherLocator
Требования
Заголовок: afxinet.h
CGopherLocator::CGopherLocator
Эта функция-член вызывается для создания CGopherLocator объекта.
CGopherLocator(const CGopherLocator& ref);
Параметры
ref;
Ссылка на постоянный CGopherLocator объект.
Замечания
Вы никогда не создаете объект напрямую CGopherLocator . Вместо этого вызовите CGopherConnection::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;
Возвращаемое значение
Указатель символа на данные строки.
Замечания
Символы не копируются; Возвращается только указатель.