wininet.h

#pragma once
/*
  Èíñòðóìåíòû äëÿ ðàáîòû ñ Wininet.
*/

//The maximum amount of data allocated for skachvanie in memory.
#define WININET_MAXBYTES_TO_MEM  (10 * 1024 * 1024)

#include "mem.h"

namespace Wininet
{
  //Structure for CallURL.
  typedef struct
  {
    bool bAutoProxy;                   //Make attempts to connect with WICF_USE_IE_PROXY, then without it, for each attempt.
    BYTE bTryCount;                    //The number of attempts, at a minimum should be 1.
    DWORD dwRetryDelay;                //Delay Mezhuyev connections.
    HANDLE hStopEvent;                 //Signal priryvaniya.
    LPSTR pstrUserAgent;               //UserAgent.
    LPSTR pstrURL;                     //URL.

    DWORD Connect_dwFlags;             //Flags WICF_ *.

    LPSTR SendRequest_pstrReferer;     //Referel
    void *SendRequest_pPostData;       //Post-data.
    DWORD SendRequest_dwPostDataSize;  //The size of the settlement data.
    DWORD SendRequest_dwFlags;         //Flags WISRF_ *.

    DWORD DownloadData_dwSizeLimit;    //Limit on downloaded data.
    LPWSTR DownloadData_pstrFileName;  //If not NULL, then the downloading of data occurs in this file.
  }CALLURLDATA;

  //Flags for _Connect.
  enum
  {
    WICF_USE_IE_PROXY = 0x1 //Whether to use when connecting from the proxy settings IE.
  };

  //Flags for SendRequest.
  enum
  {
    WISRF_METHOD_GET      = 0x0, //Use the method GET. (DEFAULT)
    WISRF_METHOD_POST     = 0x1, //Use the method POST.
    WISRF_KEEP_CONNECTION = 0x2, //Maintain the connection after vypoleneniya request. This option is not
                                 //guarantees the preservation of the connection, it depends on the server.
    WISRF_IS_HTTPS        = 0x4 //This query is performed over HTTPS protocol.
  };

  /*
    Èíèöèàëèçàöèÿ.
  */
  void Init(void);

  /*
    Äåèíèöèàëèçàöèÿ.
  */
  void Uninit(void);

  /*
    Ïîäêëþ÷åíèå ê ñåðâåðó ïî HTTP/HTTPS ïðîòîêîëó.

    IN pstrUserAgent - User-Agent, åñëè NULL, òî èñïîëüçóþåòñÿ çíà÷åíèå ïî óìîë÷àíèþ.
    IN pstrHost      - àäðåñ ñåðâåðà, IP èëè äîìåí.
    IN wPort         - ïîðò ñåðâåðà.
    IN dwFlags       - ôëàãè WICF_*.

    Return           - õýíäë ñîåäèíåíèÿ èëè NULL.
  */
  HINTERNET _Connect(LPSTR pstrUserAgent, LPSTR pstrHost, WORD wPort, DWORD dwFlags);

  /*
    Çàêðûòèå ñîåäèíåíèÿ, îòêðûòîãî ïðè ïîìîùè _Connect.

    IN hConnect - õýíäë ñîåäèíåíèÿ.
  */
  void _CloseConnection(HINTERNET hConnect);

  /*
    Çàêðûòèå õýíäëà, è âñåõ åãî ðîäèòåëåé.

    IN OUT handle - õýíäë.
  */
  void _closeWithParents(HINTERNET handle);

  /*
    Âûçîâ InternetStatusCallback.

    ... -  ñîãëàñíî InternetStatusCallback.

    Return - true - ôóíêöèÿ âûçâàíà,
             false - ôóíêöèÿ íå âûçâàíà.
  */
  bool callCallback(HINTERNET handle, DWORD_PTR context, DWORD internetStatus, LPVOID statusInformation, DWORD statusInformationLength);

  /*
    Îòïðàâêà çàïðîñà.

    IN hConnect       - õýíäë ñîåäèíåíèÿ.
    IN pstrURI        - çàïðàøàâàåìûé îáúåêò.
    IN pstrReferer    - ðåôåðåë èëè NULL.
    IN pPostData      - ïîñò äàííûå èëè NULL.
    IN dwPostDataSize - ðàçìåð pPostData.
    IN dwFlags        - Flags WISRF_ *.

    Return            - â ñëó÷àè óñïåõà õýíëî ïîëó÷åíûé îò HttpOpenRequest, èëè NULL â ñëó÷àè îøèáêè.
  */
  HINTERNET _SendRequest(HINTERNET hConnect, LPSTR pstrURI, LPSTR pstrReferer, void *pPostData, DWORD dwPostDataSize, DWORD dwFlags);

  /*
    Ñêà÷èâàíèå äàííûõ.

    IN hRequest    - õýíäë çàïðîñà.
    OUT pBuf       - áóôôåð äëÿ äàííûõ, ïîñëå èñïîëüçîâàíèå íåîáõîäèìî óäàëèòü ÷åðåç Mem. Ìîæåò
                     áûòü NULL.
    IN dwSizeLimit - ëèìèò ñêà÷èâàåìûõ áàéò, åñëè ðàâíî 0 èëè áîëüøå WININET_MAXBYTES_TO_MEM, òî
                     dwSizeLimit =  WININET_MAXBYTES_TO_MEM;
    IN hStopEvent  - õýíäë ñîáûòèÿ äëÿ ïðåðûâàíèÿ ñêà÷èâàíèÿ èëè NULL.

    Return         - true - â ñëó÷àè óñïåõà,
                     false - â ñëó÷àè îøèáêè, â òîì ÷èñëå ñðàáàòûâàåíèè hStopEvent è ïðèâûøåíèÿ
                     dwSizeLimit. Åñëè âîçíèêëà îøèáêà, òî ñîåäèíåíèå íåîáõîäèìî çàêðûòü.
  */
  bool _DownloadData(HINTERNET hRequest, MEMDATA *pBuf, DWORD dwSizeLimit, HANDLE hStopEvent);
  
  /*
    Ñêà÷èâàíèå äàííûõ â ôàéë.

    IN hRequest     - õýíäë çàïðîñà.
    IN pstrFileName - èìÿ ôàéëà, â êîòîðûé áóäóò ñîõðàíåíû äàííûå.
    IN dwSizeLimit  - ëèìèò ñêà÷èâàåìûõ áàéò, åñëè ðàâíî 0, òî îãðàíè÷åíèÿ íåò.
    IN hStopEvent   - õýíäë ñîáûòèÿ äëÿ ïðåðûâàíèÿ ñêà÷èâàíèÿ èëè NULL.

    Return          - true - â ñëó÷àè óñïåõà,
                      false - â ñëó÷àè îøèáêè, â òîì ÷èñëå ñðàáàòûâàåíèè hStopEvent èëè ïðèâûøåíèÿ
                      dwSizeLimit. Åñëè âîçíèêëà îøèáêà, òî ñîåäèíåíèå íåîáõîäèìî çàêðûòü.
  */
  bool _DownloadDataToFile(HINTERNET hRequest, LPWSTR pstrFileName, DWORD dwSizeLimit, HANDLE hStopEvent);

  /*
    Îáîëî÷êà äëÿ _Connect + _SendRequest + _DownloadData(ToFile).

    IN pcud  - ïàðàìåòðû URL;
    OUT pBuf - áóôôåð äëÿ äàííûõ, ïîñëå èñïîëüçîâàíèå íåîáõîäèìî óäàëèòü ÷åðåç Mem. Ìîæåò áûòü NULL.
               Ïðè pcud->DownloadData_pstrFileName != NULL íå èìååò ñìûñëà.

    Return   - true - â ñëó÷àè óñïåõà,
               false - â ñëó÷àè îøèáêè.
  */
  bool _CallURL(CALLURLDATA *pcud, MEMDATA *pBuf);

  /*
    Ïîëó÷åíèå User-Agent îò Internet Explorer.

    Return - User-Agent, èëè NULL â ñëó÷àè îèøáêè. Ïàìÿòü äîëæíà áûòü îñâîáîæäåíà ÷åðåç Mem.
  */
  LPSTR _GetIEUserAgent(void);

  /*
    Òåñò ñîêðîñòè çàãðóçêè URL.

    IN url       - URL.
    IN stopEvent - ñîáûòèå îñòàíîâêè èëè NULL.

    Return       - çàòðà÷åíîå âðåìÿ â ms, èëè 0 - â ñëó÷àè îøèáêè.
  */
  DWORD _testDownloadDelay(LPSTR url, HANDLE stopEvent);

  /*
    Íàñòðîéêà íàä InternetQueryOptionA ñ àâòîâûëåäåíèåì ïàìÿòè.

    IN internet - õýíäë.
    IN option   - îïöèÿ.
    OUT lenght  - ðàçìåð äàííûõ. Åñëè ýòî ñòðîêà, ðàçìåð áóäåò âîçðàøåí áåç íóëåîâîãî ñèìâîëà.

    Return      - äàííûå (íóæíî îñâîáîäèòü ÷åðåç Mem), åñëè ýòî ñòðîêà, òî îí áóäåò ñ îêîí÷àíèåì íà
                  íóëåâîé ñèìâîë. Èëè NULL â ñëó÷àè îøèáêè.
  */
  void *_queryOptionExA(HINTERNET internet, DWORD option, LPDWORD lenght);

  /*
    Íàñòðîéêà íàä InternetQueryOptionW ñ àâòîâûëåäåíèåì ïàìÿòè.

    IN internet - õýíäë.
    IN option   - îïöèÿ.
    OUT lenght  - ðàçìåð äàííûõ â ÁÀÉÒÀÕ. Åñëè ýòî ñòðîêà, ðàçìåð áóäåò âîçðàøåí áåç íóëåîâîãî ñèìâîëà.

    Return      - äàííûå (íóæíî îñâîáîäèòü ÷åðåç Mem), åñëè ýòî ñòðîêà, òî îí áóäåò ñ îêîí÷àíèåì íà
                  íóëåâîé ñèìâîë. Èëè NULL â ñëó÷àè îøèáêè.
  */
  void *_queryOptionExW(HINTERNET internet, DWORD option, LPDWORD lenght);

  /*    Customize over HttpQueryInfoA with avtovyledeniem memory.

    IN internet - the handle.
    IN infoLevel - flags indicating data to get.
    OUT lenght - the size of a string without the null character.

    Return - string ending in a null character (must be freed by Mem),
                  or NULL in case of error.
  */
  LPSTR _queryInfoExA(HINTERNET request, DWORD infoLevel, LPDWORD lenght, LPDWORD index);
};