CGopherConnection::CreateLocator

CGopherLocator CreateLocator( LPCTSTR pstrDisplayString, LPCTSTR pstrSelectorString, DWORD dwGopherType );

static CGopherLocator CreateLocator( LPCTSTR pstrLocator );

static CGopherLocator CreateLocator( LPCTSTR pstrServerName,
                                     LPCTSTR pstrDisplayString,
                                     LPCTSTR pstrSelectorString,
                                     DWORD dwGopherType,
                                     INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER
                                   );

返回值:一个CGopherLocator对象。

参数:
pstrDisplayString指向一个包含要获得的Gopher文档或路径(目录)名的字符串。如果为NULL,则返回Gopher服务器的缺省目录。
pstrSelectorString指向将被送到Gopher服务器的选择器字符串的指针,以获取一个项目。pstrSelectorString可以为NULL。
dwGopherType指定pstrSelectorString表示一个目录还是表示一个文档,请求是Gopher还是Gopher+。请参阅联机文档“ActiveX SDK”中的GOPHER_FIND_DATA结构的属性。
pstrLocator一个指向标识待打开文件的字符串的指针。一般来说此字符串通过调用CGopherFileFind::GetLocator返回。
pstrServerName指向包含Gopher服务器名称的字符串指针。
nPort标识Internet连接端口的数字。

说明:
调用此成员函数构造一个Gopher定位器,查找或标识Gopher服务器上的文件。静态版本的成员函数需要指定一个服务器,而非静态版本使用连接对象的服务器名。
为了从Gopher服务器获得信息,应用必须首先获得一个Gopher定位器,然后应用必须把定位器作为一个不透明标号(即应用必须使用此定位器,但不可直接操纵或比较它)。通常应用使用定位器来调用CGopherFileFind::FindFile成员函数,获取一条指定信息。

请参阅:
CFtpConnection, CHttpConnection, CInternetConnection, CGopherLocator, CGopherFileFind