Edit

Share via


CGopherFile Class

Provides the functionality to find and read files on a gopher server.

Note

The classes CGopherConnection, CGopherFile, CGopherFileFind, CGopherLocator and their members have been deprecated because they do not work on the Windows XP platform, but they will continue to work on earlier platforms.

Syntax

class CGopherFile : public CInternetFile

Members

Protected Constructors

Name Description
CGopherFile::CGopherFile Constructs a CGopherFile object.

Remarks

The gopher service does not allow users to write data to a gopher file because this service functions mainly as a menu-driven interface for finding information. The CGopherFile member functions Write, WriteString, and Flush are not implemented for CGopherFile. Calling these functions on a CGopherFile object, returns a CNotSupportedException.

To learn more about how CGopherFile works with the other MFC Internet classes, see the article Internet Programming with WinInet.

Inheritance Hierarchy

CObject

CFile

CStdioFile

CInternetFile

CGopherFile

Requirements

Header: afxinet.h

CGopherFile::CGopherFile

This member function is called to construct a CGopherFile object.

CGopherFile(
    HINTERNET hFile,
    CGopherLocator& refLocator,
    CGopherConnection* pConnection);

CGopherFile(
    HINTERNET hFile,
    HINTERNET hSession,
    LPCTSTR pstrLocator,
    DWORD dwLocLen,
    DWORD_PTR dwContext);

Parameters

hFile
A handle to an HINTERNET file.

refLocator
A reference to a CGopherLocator object.

pConnection
A pointer to a CGopherConnection object.

hSession
A handle to the current Internet session.

pstrLocator
A pointer to a string used to locate the gopher server. See Gopher Sessions for more information about gopher locators.

dwLocLen
A DWORD containing the number of bytes in pstrLocator.

dwContext
A pointer to the context identifier of the file being opened.

Remarks

You need a CGopherFile object to read from a file during a gopher Internet session.

You never create a CGopherFile object directly. Instead, call CGopherConnection::OpenFile to open a file on a gopher server.

See also

CInternetFile Class
Hierarchy Chart
CInternetFile Class
CGopherLocator Class
CGopherFileFind Class
CGopherConnection Class