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

Reference

CGopherConnection Class

Hierarchy Chart

CFtpConnection Class

CHttpConnection Class

CInternetConnection Class

CGopherFile Class

CGopherLocator Class

CInternetSession Class