GopherOpenFile Function

Begins reading a Gopher data file from a Gopher server.

Syntax

HINTERNET GopherOpenFile%(
    IN HINTERNET hConnect,
    IN LPCTSTR% lpszLocator,
    IN LPCTSTR% lpszView,
    IN DWORD dwFlags,
    IN DWORD dwContext
);

The actual syntax of this function varies between its ANSI and Unicode implementations. See the Win32 Internet Functions Syntax document for details.

Parameters

hConnect

Handle to a Gopher session returned by InternetConnect.

lpszLocator

Address of a string that identifies the file to open. Generally, this locator is returned from a call to GopherFindFirstFile or InternetFindNextFile. Because the Gopher protocol has no concept of a current directory, the locator is always fully qualified.

lpszView

Address of a string that describes the view to open if several views of the file exist at the server. If lpszView is NULL, the function uses the default file view.

dwFlags

Unsigned long integer value that contains the conditions under which subsequent transfers occur. Can be any combination of the following values:

INTERNET_FLAG_HYPERLINK

INTERNET_FLAG_NEED_FILE

INTERNET_FLAG_NO_CACHE_WRITE

INTERNET_FLAG_RELOAD

INTERNET_FLAG_RESYNCHRONIZE

dwContext

Unsigned long integer value that contains an application-defined value that associates this operation with any application data.

Return Value

Returns a handle if successful, or NULL if the file cannot be opened. To get extended error information, call GetLastError or InternetGetLastResponseInfo.

Remarks

GopherOpenFile opens a file at a Gopher server. Because a file cannot actually be opened or locked at a server, this function simply associates location information with a handle that an application can use for file-based operations such as InternetReadFile or GopherGetAttribute.

Function Information

Windows NT	Use version 4.0 and later. Implemented as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 3.0 (ANSI only), 5 (ANSI and Unicode)

See Also

Microsoft Win32 Internet Functions Overview, Gopher Sessions, Microsoft Win32 Internet Functions Reference, Gopher Functions

Does this content meet your programming needs? Write us!

Back to top