Share via


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

Concepts

Win32 Internet Extensions (WinInet)

Prerequisites for Internet Client Classes

Writing an Internet Client Application Using MFC WinInet Classes