CGopherLocator 类
从 gopher 服务器获取 gopher 定位符，确定定位器的类型，并使定位符可用于 CGopherFileFind。
注意
我们已弃用 CGopherConnection、CGopherFile、CGopherFileFind、CGopherLocator 类及其成员，因为它们在 Windows XP 平台上不起作用，但它们在早期平台上依然有效。
语法
class CGopherLocator : public CObject
成员
公共构造函数
| 名称 | 描述 |
|---|---|
| CGopherLocator::CGopherLocator | 构造 CGopherLocator 对象。 |
公共方法
| 名称 | 描述 |
|---|---|
| CGopherLocator::GetLocatorType | 分析 gopher 定位符并确定其属性。 |
公共运算符
| “属性” | 描述 |
|---|---|
| CGopherLocator::operator LPCTSTR | 直接访问作为 C 样式字符串存储在 CGopherLocator 对象中的字符。 |
注解
应用程序必须先获取 gopher 服务器的定位符，然后才能从该服务器检索信息。 拥有定位符后，它必须将该定位符视为不透明令牌。
每个 gopher 定位符都有用于确定找到的文件或服务器的类型的属性。 有关 gopher 定位符类型的列表，请参阅 GetLocatorType。
应用程序通常使用定位符调用 CGopherFileFind::FindFile 来检索特定信息片段。
若要详细了解 CGopherLocator 如何与其他 MFC Internet 类配合工作，请参阅使用 WinInet 进行 Internet 编程一文。
继承层次结构
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；否则为 0。 如果调用失败，可能会调用 Win32 函数 GetLastError 以确定错误原因。
备注
可能的类型如下：
| 值 | 含义 |
|---|---|
| GOPHER_TYPE_TEXT_FILE | ASCII 文本文件。 |
| GOPHER_TYPE_DIRECTORY | 其他 Gopher 项的目录。 |
| GOPHER_TYPE_CSO | CSO 电话簿服务器。 |
| GOPHER_TYPE_ERROR | 指示错误条件。 |
| GOPHER_TYPE_MAC_BINHEX | BINHEX 格式的 Macintosh 文件。 |
| 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
这个有用的强制转换运算符提供了一种高效的方法来访问 CGopherLocator 对象中包含的以 null 结尾的 C 字符串。
operator LPCTSTR () const;
返回值
指向字符串数据的字符指针。
注解
不复制字符；只返回指针。