dlls/wininet/gopher.c

   1 /*
   2  * WININET - Gopher implementation
   3  *
   4  * Copyright 2003 Kirill Smelkov
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #include <stdarg.h>
  22
  23 #include "windef.h"
  24 #include "winbase.h"
  25 #include "wininet.h"
  26
  27 #include "wine/debug.h"
  28
  29 WINE_DEFAULT_DEBUG_CHANNEL(wininet);
  30
  31 /***********************************************************************
  32  *           GopherCreateLocatorA (WININET.@)
  33  *
  34  * Create a Gopher locator string from its component parts
  35  *
  36  * PARAMS
  37  *  lpszHost            [I] host name
  38  *  nServerPort         [I] port in host byteorder or INTERNET_INVALID_PORT_NUMBER for default
  39  *  lpszDisplayString   [I] document/directory to display (NULL - default directory)
  40  *  lpszSelectorString  [I] selector string for server (NULL - none)
  41  *  dwGopherType        [I] selector type (see GOPHER_TYPE_xxx)
  42  *  lpszLocator         [O] buffer for locator string
  43  *  lpdwBufferLength    [I] locator buffer length
  44  *
  45  * RETURNS
  46  *  TRUE  on success
  47  *  FALSE on failure
  48  *
  49  */
  50 BOOL WINAPI GopherCreateLocatorA(
  51  LPCSTR        lpszHost,
  52  INTERNET_PORT nServerPort,
  53  LPCSTR        lpszDisplayString,
  54  LPCSTR        lpszSelectorString,
  55  DWORD         dwGopherType,
  56  LPSTR         lpszLocator,
  57  LPDWORD       lpdwBufferLength
  58 )
  59 {
  60     FIXME("stub\n");
  61     return FALSE;
  62 }
  63
  64 /***********************************************************************
  65  *           GopherCreateLocatorW (WININET.@)
  66  *
  67  * See GopherCreateLocatorA.
  68  */
  69 BOOL WINAPI GopherCreateLocatorW(
  70  LPCWSTR       lpszHost,
  71  INTERNET_PORT nServerPort,
  72  LPCWSTR       lpszDisplayString,
  73  LPCWSTR       lpszSelectorString,
  74  DWORD         dwHopherType,
  75  LPWSTR        lpszLocator,
  76  LPDWORD       lpdwBufferLength
  77 )
  78 {
  79     FIXME("stub\n");
  80     return FALSE;
  81 }
  82
  83 /***********************************************************************
  84  *           GopherFindFirstFileA (WININET.@)
  85  *
  86  * Create a session and locate the requested documents
  87  *
  88  * PARAMS
  89  *  hConnect        [I] Handle to a Gopher session returned by InternetConnect
  90  *  lpszLocator     [I] - address of a string containing the name of the item to locate.
  91  *                      - Locator created by the GopherCreateLocator function.
  92  * lpszSearchString [I] what to search for if this request is to an index server.
  93  *                      Otherwise, this parameter should be NULL.
  94  * lpFindData       [O] retrieved information
  95  * dwFlags          [I] INTERNET_FLAG_{HYPERLINK, NEED_FILE, NO_CACHE_WRITE, RELOAD, RESYNCHRONIZE}
  96  * dwContext        [I] application private value
  97  *
  98  * RETURNS
  99  *  HINTERNET handle on success
 100  *  NULL on error
 101  */
 102 HINTERNET WINAPI GopherFindFirstFileA(
 103  HINTERNET hConnect,
 104  LPCSTR    lpszLocator,
 105  LPCSTR    lpszSearchString,
 106  LPGOPHER_FIND_DATAA
 107            lpFindData,
 108  DWORD     dwFlags,
 109  DWORD_PTR dwContext
 110 )
 111 {
 112     FIXME("stub\n");
 113     return NULL;
 114 }
 115
 116 /***********************************************************************
 117  *           GopherFindFirstFileW (WININET.@)
 118  *
 119  * See GopherFindFirstFileA.
 120  */
 121 HINTERNET WINAPI GopherFindFirstFileW(
 122  HINTERNET hConnect,
 123  LPCWSTR   lpszLocator,
 124  LPCWSTR   lpszSearchString,
 125  LPGOPHER_FIND_DATAW
 126            lpFindData,
 127  DWORD     dwFlags,
 128  DWORD_PTR dwContext
 129 )
 130 {
 131     FIXME("stub\n");
 132     return NULL;
 133 }
 134
 135 /***********************************************************************
 136  *           GopherGetAttributeA (WININET.@)
 137  *
 138  * Retrieves the specific attribute information from the server.
 139  *
 140  * RETURNS
 141  *  TRUE on success
 142  *  FALSE on failure
 143  */
 144 BOOL WINAPI GopherGetAttributeA(
 145  HINTERNET hConnect,
 146  LPCSTR    lpszLocator,
 147  LPCSTR    lpszAttributeName,
 148  LPBYTE    lpBuffer,
 149  DWORD     dwBufferLength,
 150  LPDWORD   lpdwCharactersReturned,
 151  GOPHER_ATTRIBUTE_ENUMERATORA
 152            lpfnEnumerator,
 153  DWORD_PTR dwContext
 154 )
 155 {
 156     FIXME("stub\n");
 157     return FALSE;
 158 }
 159
 160 /***********************************************************************
 161  *           GopherGetAttributeW (WININET.@)
 162  *
 163  * See GopherGetAttributeA.
 164  */
 165 BOOL WINAPI GopherGetAttributeW(
 166  HINTERNET hConnect,
 167  LPCWSTR   lpszLocator,
 168  LPCWSTR   lpszAttributeName,
 169  LPBYTE    lpBuffer,
 170  DWORD     dwBufferLength,
 171  LPDWORD   lpdwCharactersReturned,
 172  GOPHER_ATTRIBUTE_ENUMERATORW
 173            lpfnEnumerator,
 174  DWORD_PTR dwContext
 175 )
 176 {
 177     FIXME("stub\n");
 178     return FALSE;
 179 }
 180
 181 /***********************************************************************
 182  *           GopherGetLocatorTypeA (WININET.@)
 183  *
 184  * Parses a Gopher locator and determines its attributes.
 185  *
 186  * PARAMS
 187  *  lpszLocator     [I] Address of the Gopher locator string to parse
 188  *  lpdwGopherType  [O] destination for bitmasked type of locator
 189  *
 190  * RETURNS
 191  *  TRUE  on success
 192  *  FALSE on failure
 193  */
 194 BOOL WINAPI GopherGetLocatorTypeA(LPCSTR lpszLocator, LPDWORD lpdwGopherType)
 195 {
 196     FIXME("stub\n");
 197     return FALSE;
 198 }
 199
 200 /***********************************************************************
 201  *           GopherGetLocatorTypeW (WININET.@)
 202  *
 203  * See GopherGetLocatorTypeA.
 204  */
 205 BOOL WINAPI GopherGetLocatorTypeW(LPCWSTR lpszLocator, LPDWORD lpdwGopherType)
 206 {
 207     FIXME("stub\n");
 208     return FALSE;
 209 }
 210
 211 /***********************************************************************
 212  *           GopherOpenFileA (WININET.@)
 213  *
 214  * Begins reading a Gopher data file from a Gopher server.
 215  *
 216  * PARAMS
 217  *  hConnect    [I] handle to a Gopher session
 218  *  lpszLocator [I] file locator
 219  *  lpszView    [I] file view (or default if NULL)
 220  *  dwFlags     [I] INTERNET_FLAG_{HYPERLINK, NEED_FILE, NO_CACHE_WRITE, RELOAD, RESYNCHRONIZE}
 221  *  dwContext   [I] application private value
 222  *
 223  * RETURNS
 224  *  handle  on success
 225  *  NULL    on error
 226  */
 227 HINTERNET WINAPI GopherOpenFileA(
 228  HINTERNET hConnect,
 229  LPCSTR    lpszLocator,
 230  LPCSTR    lpszView,
 231  DWORD     dwFlags,
 232  DWORD_PTR dwContext
 233 )
 234 {
 235     FIXME("stub\n");
 236     return NULL;
 237 }
 238
 239 /***********************************************************************
 240  *           GopherOpenFileW (WININET.@)
 241  *
 242  * See GopherOpenFileA.
 243  */
 244 HINTERNET WINAPI GopherOpenFileW(
 245  HINTERNET hConnect,
 246  LPCWSTR   lpszLocator,
 247  LPCWSTR   lpszView,
 248  DWORD     dwFlags,
 249  DWORD_PTR dwContext
 250 )
 251 {
 252     FIXME("stub\n");
 253     return NULL;
 254 }