CGopherFile Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CGopherFile Class.

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

System_CAPS_ICON_note.jpg 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.

class CGopherFile : public CInternetFile  

Protected Constructors

NameDescription
CGopherFile::CGopherFileConstructs a CGopherFile object.

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.

CObject

CFile

CStdioFile

CInternetFile

CGopherFile

Header: afxinet.h

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.

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

Show: