CGopherConnection::OpenFile

Call this member function to open a file on a gopher server.

CGopherFile* OpenFile(
   CGopherLocator& refLocator,
   DWORD dwFlags = 0,
   LPCTSTR pstrView = NULL,
   DWORD_PTR dwContext = 1 
);

Parameters

  • refLocator
    A reference to a CGopherLocator object.

  • dwFlags
    Any combination of INTERNET_FLAG_* flags. See CInternetSession::OpenUrl for further information on INTERNET_FLAG_* flags.

  • pstrView
    A pointer to a file-view string. If several views of the file exist at the server, this parameter specifies which file view to open. If pstrView is NULL, the default file view is used.

  • dwContext
    The context ID for the file being opened. See Remarks for more information about dwContext.

Return Value

A pointer to the CGopherFile object to be opened.

Remarks

Override the dwContext default to set the context identifier to a value of your choosing. The context identifier is associated with this specific operation of the CGopherConnection object created by its CInternetSession object. The value is returned to CInternetSession::OnStatusCallback to provide status on the operation with which it is identified. See the article Internet First Steps: WinInet for more information about the context identifier.

Requirements

Header: afxinet.h

See Also

Concepts

CGopherConnection Class

CGopherConnection Members

Hierarchy Chart

CFtpConnection Class

CHttpConnection Class

CInternetConnection Class

CGopherFile Class

CGopherLocator Class

CInternetSession Class