Steps in a Typical Gopher Client Application

The following table shows the steps you might perform in a typical gopher client application.

Your goal	Actions you take	Effects
Begin a gopher session.	Create a CInternetSession object.	Initializes WinInet and connects to server.
Connect to a gopher server.	Use CInternetSession::GetGopherConnection.	Returns a CGopherConnection object.
Find the first resource in the gopher.	Use CGopherFileFind::FindFile.	Finds the first file. Returns FALSE if no files are found.
Find the next resource in the gopher.	Use CGopherFileFind::FindNextFile.	Finds the next file. Returns FALSE if the file is not found.
Open the file found by FindFile or FindNextFile for reading.	Get a gopher locator using CGopherFileFind::GetLocator. Use CGopherConnection::OpenFile.	Opens the file specified by the locator. OpenFile returns a CGopherFile object.
Open a file using a gopher locator you supply.	Create a gopher locator using CGopherConnection::CreateLocator. Use CGopherConnection::OpenFile.	Opens the file specified by the locator. OpenFile returns a CGopherFile object.
Read from the file.	Use CGopherFile.	Reads the specified number of bytes, using a buffer you supply.
Handle exceptions.	Use the CInternetException class.	Handles all common Internet exception types.
End the gopher session.	Dispose of the CInternetSession object.	Automatically cleans up open file handles and connections.

See Also