CGopherLocator 类

项目
06/16/2023

从 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 编程一文。

继承层次结构

CObject

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;

返回值

指向字符串数据的字符指针。

注解

不复制字符；只返回指针。

另请参阅

CObject 类
 层次结构图
 CGopherFileFind 类

通过