dlls/wininet/internet.h

   1 /*
   2  * Wininet
   3  *
   4  * Copyright 1999 Corel Corporation
   5  *
   6  * Ulrich Czekalla
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2.1 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  21  */
  22
  23 #ifndef _WINE_INTERNET_H_
  24 #define _WINE_INTERNET_H_
  25
  26 #ifndef __WINE_CONFIG_H
  27 # error You must include config.h to use this header
  28 #endif
  29
  30 #include "wine/unicode.h"
  31 #include "wine/list.h"
  32
  33 #include <time.h>
  34 #ifdef HAVE_NETDB_H
  35 # include <netdb.h>
  36 #endif
  37 #ifdef HAVE_NETINET_IN_H
  38 # include <sys/types.h>
  39 # include <netinet/in.h>
  40 #endif
  41 #ifdef HAVE_SYS_SOCKET_H
  42 # include <sys/socket.h>
  43 #endif
  44
  45 #if !defined(__MINGW32__) && !defined(_MSC_VER)
  46 #define closesocket close
  47 #define ioctlsocket ioctl
  48 #endif /* __MINGW32__ */
  49
  50 /* used for netconnection.c stuff */
  51 typedef struct
  52 {
  53     BOOL useSSL;
  54     int socketFD;
  55     void *ssl_s;
  56     char *peek_msg;
  57     char *peek_msg_mem;
  58     size_t peek_len;
  59 } WININET_NETCONNECTION;
  60
  61 static inline LPWSTR WININET_strdupW( LPCWSTR str )
  62 {
  63     LPWSTR ret = HeapAlloc( GetProcessHeap(), 0, (strlenW(str) + 1)*sizeof(WCHAR) );
  64     if (ret) strcpyW( ret, str );
  65     return ret;
  66 }
  67
  68 static inline LPWSTR WININET_strdup_AtoW( LPCSTR str )
  69 {
  70     int len = MultiByteToWideChar( CP_ACP, 0, str, -1, NULL, 0);
  71     LPWSTR ret = HeapAlloc( GetProcessHeap(), 0, len * sizeof(WCHAR) );
  72     if (ret)
  73         MultiByteToWideChar( CP_ACP, 0, str, -1, ret, len);
  74     return ret;
  75 }
  76
  77 static inline LPSTR WININET_strdup_WtoA( LPCWSTR str )
  78 {
  79     int len = WideCharToMultiByte( CP_ACP, 0, str, -1, NULL, 0, NULL, NULL);
  80     LPSTR ret = HeapAlloc( GetProcessHeap(), 0, len );
  81     if (ret)
  82         WideCharToMultiByte( CP_ACP, 0, str, -1, ret, len, NULL, NULL);
  83     return ret;
  84 }
  85
  86 static inline void WININET_find_data_WtoA(LPWIN32_FIND_DATAW dataW, LPWIN32_FIND_DATAA dataA)
  87 {
  88     dataA->dwFileAttributes = dataW->dwFileAttributes;
  89     dataA->ftCreationTime   = dataW->ftCreationTime;
  90     dataA->ftLastAccessTime = dataW->ftLastAccessTime;
  91     dataA->ftLastWriteTime  = dataW->ftLastWriteTime;
  92     dataA->nFileSizeHigh    = dataW->nFileSizeHigh;
  93     dataA->nFileSizeLow     = dataW->nFileSizeLow;
  94     dataA->dwReserved0      = dataW->dwReserved0;
  95     dataA->dwReserved1      = dataW->dwReserved1;
  96     WideCharToMultiByte(CP_ACP, 0, dataW->cFileName, -1,
  97         dataA->cFileName, sizeof(dataA->cFileName),
  98         NULL, NULL);
  99     WideCharToMultiByte(CP_ACP, 0, dataW->cAlternateFileName, -1,
 100         dataA->cAlternateFileName, sizeof(dataA->cAlternateFileName),
 101         NULL, NULL);
 102 }
 103
 104 typedef enum
 105 {
 106     WH_HINIT = INTERNET_HANDLE_TYPE_INTERNET,
 107     WH_HFTPSESSION = INTERNET_HANDLE_TYPE_CONNECT_FTP,
 108     WH_HGOPHERSESSION = INTERNET_HANDLE_TYPE_CONNECT_GOPHER,
 109     WH_HHTTPSESSION = INTERNET_HANDLE_TYPE_CONNECT_HTTP,
 110     WH_HFILE = INTERNET_HANDLE_TYPE_FTP_FILE,
 111     WH_HFTPFINDNEXT = INTERNET_HANDLE_TYPE_FTP_FIND,
 112     WH_HHTTPREQ = INTERNET_HANDLE_TYPE_HTTP_REQUEST,
 113 } WH_TYPE;
 114
 115 #define INET_OPENURL 0x0001
 116 #define INET_CALLBACKW 0x0002
 117
 118 typedef struct _WININETHANDLEHEADER WININETHANDLEHEADER, *LPWININETHANDLEHEADER;
 119
 120 typedef struct {
 121     void (*Destroy)(WININETHANDLEHEADER*);
 122     void (*CloseConnection)(WININETHANDLEHEADER*);
 123     DWORD (*QueryOption)(WININETHANDLEHEADER*,DWORD,void*,DWORD*,BOOL);
 124     DWORD (*SetOption)(WININETHANDLEHEADER*,DWORD,void*,DWORD);
 125     DWORD (*ReadFile)(WININETHANDLEHEADER*,void*,DWORD,DWORD*);
 126     DWORD (*ReadFileExA)(WININETHANDLEHEADER*,INTERNET_BUFFERSA*,DWORD,DWORD_PTR);
 127     DWORD (*ReadFileExW)(WININETHANDLEHEADER*,INTERNET_BUFFERSW*,DWORD,DWORD_PTR);
 128     BOOL (*WriteFile)(WININETHANDLEHEADER*,const void*,DWORD,DWORD*);
 129     DWORD (*QueryDataAvailable)(WININETHANDLEHEADER*,DWORD*,DWORD,DWORD_PTR);
 130     DWORD (*FindNextFileW)(WININETHANDLEHEADER*,void*);
 131 } HANDLEHEADERVtbl;
 132
 133 struct _WININETHANDLEHEADER
 134 {
 135     WH_TYPE htype;
 136     const HANDLEHEADERVtbl *vtbl;
 137     HINTERNET hInternet;
 138     DWORD  dwFlags;
 139     DWORD_PTR dwContext;
 140     DWORD  dwError;
 141     DWORD  dwInternalFlags;
 142     LONG   refs;
 143     INTERNET_STATUS_CALLBACK lpfnStatusCB;
 144     struct list entry;
 145     struct list children;
 146 };
 147
 148
 149 typedef struct
 150 {
 151     WININETHANDLEHEADER hdr;
 152     LPWSTR  lpszAgent;
 153     LPWSTR  lpszProxy;
 154     LPWSTR  lpszProxyBypass;
 155     LPWSTR  lpszProxyUsername;
 156     LPWSTR  lpszProxyPassword;
 157     DWORD   dwAccessType;
 158 } WININETAPPINFOW, *LPWININETAPPINFOW;
 159
 160
 161 typedef struct
 162 {
 163     WININETHANDLEHEADER hdr;
 164     WININETAPPINFOW *lpAppInfo;
 165     LPWSTR  lpszHostName; /* the final destination of the request */
 166     LPWSTR  lpszServerName; /* the name of the server we directly connect to */
 167     LPWSTR  lpszUserName;
 168     LPWSTR  lpszPassword;
 169     INTERNET_PORT nHostPort; /* the final destination port of the request */
 170     INTERNET_PORT nServerPort; /* the port of the server we directly connect to */
 171     struct sockaddr_in socketAddress;
 172 } WININETHTTPSESSIONW, *LPWININETHTTPSESSIONW;
 173
 174 #define HDR_ISREQUEST           0x0001
 175 #define HDR_COMMADELIMITED      0x0002
 176 #define HDR_SEMIDELIMITED       0x0004
 177
 178 typedef struct
 179 {
 180     LPWSTR lpszField;
 181     LPWSTR lpszValue;
 182     WORD wFlags;
 183     WORD wCount;
 184 } HTTPHEADERW, *LPHTTPHEADERW;
 185
 186
 187 struct HttpAuthInfo;
 188
 189 typedef struct
 190 {
 191     WININETHANDLEHEADER hdr;
 192     WININETHTTPSESSIONW *lpHttpSession;
 193     LPWSTR lpszPath;
 194     LPWSTR lpszVerb;
 195     LPWSTR lpszRawHeaders;
 196     WININET_NETCONNECTION netConnection;
 197     LPWSTR lpszVersion;
 198     LPWSTR lpszStatusText;
 199     DWORD dwContentLength; /* total number of bytes to be read */
 200     DWORD dwContentRead; /* bytes of the content read so far */
 201     HTTPHEADERW *pCustHeaders;
 202     DWORD nCustHeaders;
 203     HANDLE hCacheFile;
 204     LPWSTR lpszCacheFile;
 205     struct HttpAuthInfo *pAuthInfo;
 206     struct HttpAuthInfo *pProxyAuthInfo;
 207 } WININETHTTPREQW, *LPWININETHTTPREQW;
 208
 209
 210
 211 struct WORKREQ_FTPPUTFILEW
 212 {
 213     LPWSTR lpszLocalFile;
 214     LPWSTR lpszNewRemoteFile;
 215     DWORD  dwFlags;
 216     DWORD_PTR dwContext;
 217 };
 218
 219 struct WORKREQ_FTPSETCURRENTDIRECTORYW
 220 {
 221     LPWSTR lpszDirectory;
 222 };
 223
 224 struct WORKREQ_FTPCREATEDIRECTORYW
 225 {
 226     LPWSTR lpszDirectory;
 227 };
 228
 229 struct WORKREQ_FTPFINDFIRSTFILEW
 230 {
 231     LPWSTR lpszSearchFile;
 232     LPWIN32_FIND_DATAW lpFindFileData;
 233     DWORD  dwFlags;
 234     DWORD_PTR dwContext;
 235 };
 236
 237 struct WORKREQ_FTPGETCURRENTDIRECTORYW
 238 {
 239     LPWSTR lpszDirectory;
 240     DWORD *lpdwDirectory;
 241 };
 242
 243 struct WORKREQ_FTPOPENFILEW
 244 {
 245     LPWSTR lpszFilename;
 246     DWORD  dwAccess;
 247     DWORD  dwFlags;
 248     DWORD_PTR dwContext;
 249 };
 250
 251 struct WORKREQ_FTPGETFILEW
 252 {
 253     LPWSTR lpszRemoteFile;
 254     LPWSTR lpszNewFile;
 255     BOOL   fFailIfExists;
 256     DWORD  dwLocalFlagsAttribute;
 257     DWORD  dwFlags;
 258     DWORD_PTR dwContext;
 259 };
 260
 261 struct WORKREQ_FTPDELETEFILEW
 262 {
 263     LPWSTR lpszFilename;
 264 };
 265
 266 struct WORKREQ_FTPREMOVEDIRECTORYW
 267 {
 268     LPWSTR lpszDirectory;
 269 };
 270
 271 struct WORKREQ_FTPRENAMEFILEW
 272 {
 273     LPWSTR lpszSrcFile;
 274     LPWSTR lpszDestFile;
 275 };
 276
 277 struct WORKREQ_FTPFINDNEXTW
 278 {
 279     LPWIN32_FIND_DATAW lpFindFileData;
 280 };
 281
 282 struct WORKREQ_HTTPSENDREQUESTW
 283 {
 284     LPWSTR lpszHeader;
 285     DWORD  dwHeaderLength;
 286     LPVOID lpOptional;
 287     DWORD  dwOptionalLength;
 288     DWORD  dwContentLength;
 289     BOOL   bEndRequest;
 290 };
 291
 292 struct WORKREQ_SENDCALLBACK
 293 {
 294     DWORD_PTR dwContext;
 295     DWORD     dwInternetStatus;
 296     LPVOID    lpvStatusInfo;
 297     DWORD     dwStatusInfoLength;
 298 };
 299
 300 struct WORKREQ_INTERNETOPENURLW
 301 {
 302     HINTERNET hInternet;
 303     LPWSTR     lpszUrl;
 304     LPWSTR     lpszHeaders;
 305     DWORD     dwHeadersLength;
 306     DWORD     dwFlags;
 307     DWORD_PTR dwContext;
 308 };
 309
 310 struct WORKREQ_INTERNETREADFILEEXA
 311 {
 312     LPINTERNET_BUFFERSA lpBuffersOut;
 313 };
 314
 315 struct WORKREQ_INTERNETREADFILEEXW
 316 {
 317     LPINTERNET_BUFFERSW lpBuffersOut;
 318 };
 319
 320 typedef struct WORKREQ
 321 {
 322     void (*asyncproc)(struct WORKREQ*);
 323     WININETHANDLEHEADER *hdr;
 324
 325     union {
 326         struct WORKREQ_FTPPUTFILEW              FtpPutFileW;
 327         struct WORKREQ_FTPSETCURRENTDIRECTORYW  FtpSetCurrentDirectoryW;
 328         struct WORKREQ_FTPCREATEDIRECTORYW      FtpCreateDirectoryW;
 329         struct WORKREQ_FTPFINDFIRSTFILEW        FtpFindFirstFileW;
 330         struct WORKREQ_FTPGETCURRENTDIRECTORYW  FtpGetCurrentDirectoryW;
 331         struct WORKREQ_FTPOPENFILEW             FtpOpenFileW;
 332         struct WORKREQ_FTPGETFILEW              FtpGetFileW;
 333         struct WORKREQ_FTPDELETEFILEW           FtpDeleteFileW;
 334         struct WORKREQ_FTPREMOVEDIRECTORYW      FtpRemoveDirectoryW;
 335         struct WORKREQ_FTPRENAMEFILEW           FtpRenameFileW;
 336         struct WORKREQ_FTPFINDNEXTW             FtpFindNextW;
 337         struct WORKREQ_HTTPSENDREQUESTW         HttpSendRequestW;
 338         struct WORKREQ_SENDCALLBACK             SendCallback;
 339         struct WORKREQ_INTERNETOPENURLW         InternetOpenUrlW;
 340         struct WORKREQ_INTERNETREADFILEEXA      InternetReadFileExA;
 341         struct WORKREQ_INTERNETREADFILEEXW      InternetReadFileExW;
 342     } u;
 343
 344 } WORKREQUEST, *LPWORKREQUEST;
 345
 346 HINTERNET WININET_AllocHandle( LPWININETHANDLEHEADER info );
 347 LPWININETHANDLEHEADER WININET_GetObject( HINTERNET hinternet );
 348 LPWININETHANDLEHEADER WININET_AddRef( LPWININETHANDLEHEADER info );
 349 BOOL WININET_Release( LPWININETHANDLEHEADER info );
 350 BOOL WININET_FreeHandle( HINTERNET hinternet );
 351
 352 DWORD INET_QueryOption(DWORD,void*,DWORD*,BOOL);
 353
 354 time_t ConvertTimeString(LPCWSTR asctime);
 355
 356 HINTERNET FTP_Connect(LPWININETAPPINFOW hIC, LPCWSTR lpszServerName,
 357         INTERNET_PORT nServerPort, LPCWSTR lpszUserName,
 358         LPCWSTR lpszPassword, DWORD dwFlags, DWORD_PTR dwContext,
 359         DWORD dwInternalFlags);
 360
 361 HINTERNET HTTP_Connect(LPWININETAPPINFOW hIC, LPCWSTR lpszServerName,
 362         INTERNET_PORT nServerPort, LPCWSTR lpszUserName,
 363         LPCWSTR lpszPassword, DWORD dwFlags, DWORD_PTR dwContext,
 364         DWORD dwInternalFlags);
 365
 366 BOOL GetAddress(LPCWSTR lpszServerName, INTERNET_PORT nServerPort,
 367         struct sockaddr_in *psa);
 368
 369 void INTERNET_SetLastError(DWORD dwError);
 370 DWORD INTERNET_GetLastError(void);
 371 BOOL INTERNET_AsyncCall(LPWORKREQUEST lpWorkRequest);
 372 LPSTR INTERNET_GetResponseBuffer(void);
 373 LPSTR INTERNET_GetNextLine(INT nSocket, LPDWORD dwLen);
 374
 375 BOOLAPI HTTP_HttpSendRequestW(LPWININETHTTPREQW lpwhr, LPCWSTR lpszHeaders,
 376         DWORD dwHeaderLength, LPVOID lpOptional, DWORD dwOptionalLength,
 377         DWORD dwContentLength, BOOL bEndRequest);
 378 INTERNETAPI HINTERNET WINAPI HTTP_HttpOpenRequestW(LPWININETHTTPSESSIONW lpwhs,
 379         LPCWSTR lpszVerb, LPCWSTR lpszObjectName, LPCWSTR lpszVersion,
 380         LPCWSTR lpszReferrer , LPCWSTR *lpszAcceptTypes,
 381         DWORD dwFlags, DWORD_PTR dwContext);
 382
 383 VOID SendAsyncCallback(LPWININETHANDLEHEADER hdr, DWORD_PTR dwContext,
 384                        DWORD dwInternetStatus, LPVOID lpvStatusInfo,
 385                        DWORD dwStatusInfoLength);
 386
 387 VOID INTERNET_SendCallback(LPWININETHANDLEHEADER hdr, DWORD_PTR dwContext,
 388                            DWORD dwInternetStatus, LPVOID lpvStatusInfo,
 389                            DWORD dwStatusInfoLength);
 390
 391 BOOL NETCON_connected(WININET_NETCONNECTION *connection);
 392 BOOL NETCON_init(WININET_NETCONNECTION *connnection, BOOL useSSL);
 393 BOOL NETCON_create(WININET_NETCONNECTION *connection, int domain,
 394               int type, int protocol);
 395 BOOL NETCON_close(WININET_NETCONNECTION *connection);
 396 BOOL NETCON_connect(WININET_NETCONNECTION *connection, const struct sockaddr *serv_addr,
 397                     unsigned int addrlen);
 398 BOOL NETCON_secure_connect(WININET_NETCONNECTION *connection, LPCWSTR hostname);
 399 BOOL NETCON_send(WININET_NETCONNECTION *connection, const void *msg, size_t len, int flags,
 400                 int *sent /* out */);
 401 BOOL NETCON_recv(WININET_NETCONNECTION *connection, void *buf, size_t len, int flags,
 402                 int *recvd /* out */);
 403 BOOL NETCON_query_data_available(WININET_NETCONNECTION *connection, DWORD *available);
 404 BOOL NETCON_getNextLine(WININET_NETCONNECTION *connection, LPSTR lpszBuffer, LPDWORD dwBuffer);
 405 LPCVOID NETCON_GetCert(WININET_NETCONNECTION *connection);
 406 DWORD NETCON_set_timeout(WININET_NETCONNECTION *connection, BOOL send, int value);
 407
 408 extern void URLCacheContainers_CreateDefaults(void);
 409 extern void URLCacheContainers_DeleteAll(void);
 410
 411 #define MAX_REPLY_LEN           0x5B4
 412
 413 /* Used for debugging - maybe need to be shared in the Wine debugging code ? */
 414 typedef struct
 415 {
 416     DWORD val;
 417     const char* name;
 418 } wininet_flag_info;
 419
 420 #endif /* _WINE_INTERNET_H_ */