Subversion Repositories currency_converter

Rev

Rev 10 | Rev 13 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 10 Rev 11
Line -... Line 1...
- 
 
 1 
<!DOCTYPE html>
1 
<html>
 2 
<html>
2 
 
 3 
 
3 
<head>
 4 
<head>
- 
 
 5 
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 
        <title>ViaThinkSoft Currency Converter - DLL specification</title>
 6 
        <title>ViaThinkSoft Currency Converter - DLL specification</title>
- 
 
 7 
        <style type="text/css">
- 
 
 8 
                pre { white-space: pre-wrap !important; }
- 
 
 9 
                body { font-family:system, -apple-system, ".SFNSText-Regular", "San Francisco", "Oxygen", "Ubuntu", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", sans-serif; }
- 
 
 10 
        </style>
5 
</head>
 11 
</head>
6 
 
 12 
 
7 
<body>
 13 
<body>
8 
 
 14 
 
9 
<h1>ViaThinkSoft Currency Converter - DLL specification</h1>
 15 
<h1>ViaThinkSoft Currency Converter - DLL specification</h1>
10 
 
 16 
 
11 
<p><i>Last change: 27.08.2017</i></p>
 - 
 
12 
 
 - 
 
13 
<h2>Table of Contents</h2>
 17 
<h2>Table of Contents</h2>
14 
 
 18 
 
15 
<p>These functions are exported by <b>CurConv.dll</b>:</p>
 19 
<p>These methods are exported by <b>CurConv.dll</b>:</p>
16 
 
 20 
 
17 
<ul>
 21 
<ul>
18 
        <li><a href="#DeleteAPIKey">DeleteAPIKey</a></li>
 22 
        <li><a href="#DeleteAPIKey">DeleteAPIKey</a></li>
19 
        <li><a href="#WriteAPIKey">WriteAPIKey</a></li>
 23 
        <li><a href="#WriteAPIKey">WriteAPIKey</a></li>
20 
        <li><a href="#ReadAPIKey">ReadAPIKey</a></li>
 24 
        <li><a href="#ReadAPIKey">ReadAPIKey</a></li>
21 
        <li><a href="#Convert">Convert</a></li>
 25 
        <li><a href="#Convert">Convert</a></li>
22 
        <li><a href="#AcceptedCurrencies">AcceptedCurrencies</a></li>
 26 
        <li><a href="#AcceptedCurrencies">AcceptedCurrencies</a></li>
23 
        <li><a href="#DownloadNow">DownloadNow</a></li>
 27 
        <li><a href="#DownloadNow">DownloadNow</a></li>
24 
</ul>
 28 
</ul>
25 
 
 29 
 
26 
<h2 id="DeleteAPIKey">DeleteAPIKey</h3>
 30 
<h2 id="DeleteAPIKey">DeleteAPIKey</h2>
27 
 
 31 
 
28 
<h3>Syntax</h4>
 32 
<h3>Syntax</h3>
29 
<h4>Delphi</h5>
 33 
<h4>Delphi</h4>
30 
<pre>
 - 
 
31 
function DeleteAPIKey(UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
 34 
<pre>function DeleteAPIKey(UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
32 
</pre>
 35 
</pre>
33 
<h4>C</h5>
 36 
<h4>C</h4>
34 
<pre>
 - 
 
35 
HRESULT __stdcall DeleteAPIKey(BOOL UserMode, BOOL DontShowErrors);
 37 
<pre>HRESULT __stdcall DeleteAPIKey(BOOL UserMode, BOOL DontShowErrors);
36 
</pre>
 38 
</pre>
37 
 
 39 
 
38 
<h3>Description</h4>
 40 
<h3>Description</h3>
39 
<p>Deletes the API key from the registry.</p>
 41 
<p>Deletes the API key from the registry.</p>
40 
 
 42 
 
41 
<h3>Parameters</h4>
 43 
<h3>Parameters</h3>
42 
<ul>
 44 
<ul>
43 
        <li>UserMode: If true, the API key will be deleted from <code>HKEY_LOCAL_USER</code>, otherwise it will be deleted on <code>HKEY_LOCAL_MACHINE</code>.</li>
 45 
        <li>UserMode: If true, the API key will be deleted from <code>HKEY_LOCAL_USER</code>, otherwise it will be deleted on <code>HKEY_LOCAL_MACHINE</code>.</li>
44 
        <li>DontShowErrors: If true, no errors will be displayed. If true, errors will result in a dialog box, in addition to the result code.</li>
 46 
        <li>DontShowErrors: If true, no errors will be displayed, otherwise, errors will result in a dialog box, in addition to the result code.</li>
45 
</ul>
 47 
</ul>
46 
 
 48 
 
47 
<h3>Returns</h4>
 49 
<h3>Returns</h3>
48 
<ul>
 50 
<ul>
49 
        <li>S_VTSCONV_OK (0x20000000) if the key could be successfully deleted.</li>
 51 
        <li>S_VTSCONV_OK (0x20000000) if the key could be successfully deleted.</li>
50 
        <li>S_VTSCONV_NOTHING (0x20000001) if no key could be found.</li>
 52 
        <li>S_VTSCONV_NOTHING (0x20000001) if no key could be found.</li>
51 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured.</li>
 53 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured.</li>
52 
</ul>
 54 
</ul>
53 
 
 55 
 
54 
<h2 id="WriteAPIKey">WriteAPIKey</h3>
 56 
<h2 id="WriteAPIKey">WriteAPIKey</h2>
55 
 
 57 
 
56 
<h3>Syntax</h4>
 58 
<h3>Syntax</h3>
57 
<h4>Delphi</h5>
 59 
<h4>Delphi</h4>
58 
<pre>
 - 
 
59 
function WriteAPIKey(key: LPCTSTR; UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
 60 
<pre>function WriteAPIKey(key: LPCTSTR; UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
60 
function WriteAPIKeyW(key: LPCWSTR; UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
 61 
function WriteAPIKeyW(key: LPCWSTR; UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
61 
function WriteAPIKeyA(key: LPCSTR; UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
 62 
function WriteAPIKeyA(key: LPCSTR; UserMode: BOOL; DontShowErrors: BOOL): HRESULT; stdcall;
62 
</pre>
 63 
</pre>
63 
<h4>C</h5>
 64 
<h4>C</h4>
64 
<pre>
 - 
 
65 
HRESULT __stdcall WriteAPIKeyW(LPCWSTR key, BOOL UserMode, BOOL DontShowErrors);
 65 
<pre>HRESULT __stdcall WriteAPIKeyW(LPCWSTR key, BOOL UserMode, BOOL DontShowErrors);
66 
HRESULT __stdcall WriteAPIKeyA(LPCSTR key, BOOL UserMode, BOOL DontShowErrors);
 66 
HRESULT __stdcall WriteAPIKeyA(LPCSTR key, BOOL UserMode, BOOL DontShowErrors);
67 
</pre>
 67 
</pre>
68 
 
 68 
 
69 
<h3>Description</h4>
 69 
<h3>Description</h3>
70 
<p>Writes the API key into the registry. This is usually not neccessary, since the convert functions are able to query the key from the user using the GUI.</p>
 70 
<p>Writes the API key into the registry. This is usually not necessary, since the Convert() method is able to query the key from the user using the GUI.</p>
71 
 
 71 
 
72 
<h3>Parameters</h4>
 72 
<h3>Parameters</h3>
73 
<ul>
 73 
<ul>
74 
        <li>key: The 32 digit key you received from currencylayer.com</li>
 74 
        <li>key: The 32 digit key you received from currencylayer.com</li>
75 
        <li>UserMode: If true, the API key will be written into <code>HKEY_LOCAL_USER</code>, otherwise it will be written to <code>HKEY_LOCAL_MACHINE</code>.</li>
 75 
        <li>UserMode: If true, the API key will be written to <code>HKEY_LOCAL_USER</code>, otherwise it will be written to <code>HKEY_LOCAL_MACHINE</code>.</li>
76 
        <li>DontShowErrors: If true, no errors will be displayed. If true, errors will result in a dialog box, in addition to the result code.</li>
 76 
        <li>DontShowErrors: If true, no errors will be displayed. If true, errors will result in a dialog box, in addition to the result code.</li>
77 
</ul>
 77 
</ul>
78 
 
 78 
 
79 
<h3>Returns</h4>
 79 
<h3>Returns</h3>
80 
<ul>
 80 
<ul>
81 
        <li>S_VTSCONV_OK (0x20000000) if the key could be successfully deleted.</li>
 81 
        <li>S_VTSCONV_OK (0x20000000) if the key could be successfully deleted.</li>
82 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured, e.g. if the registry is write protected.</li>
 82 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured, e.g. if the registry is write protected.</li>
83 
        <li>E_VTSCONV_BAD_ARGS (0xA0000001) if the key is invalid.</li>
 83 
        <li>E_VTSCONV_BAD_ARGS (0xA0000001) if the key is invalid.</li>
84 
</ul>
 84 
</ul>
85 
 
 85 
 
86 
<h2 id="ReadAPIKey">ReadAPIKey</h3>
 86 
<h2 id="ReadAPIKey">ReadAPIKey</h2>
87 
 
 87 
 
88 
<h3>Syntax</h4>
 88 
<h3>Syntax</h3>
89 
<h4>Delphi</h5>
 89 
<h4>Delphi</h4>
90 
<pre>
 - 
 
91 
function ReadAPIKey(key: LPTSTR; DontShowErrors: BOOL): HRESULT; stdcall;
 90 
<pre>function ReadAPIKey(key: LPTSTR; DontShowErrors: BOOL): HRESULT; stdcall;
92 
function ReadAPIKeyW(key: LPWSTR; DontShowErrors: BOOL): HRESULT; stdcall;
 91 
function ReadAPIKeyW(key: LPWSTR; DontShowErrors: BOOL): HRESULT; stdcall;
93 
function ReadAPIKeyA(key: LPSTR; DontShowErrors: BOOL): HRESULT; stdcall;
 92 
function ReadAPIKeyA(key: LPSTR; DontShowErrors: BOOL): HRESULT; stdcall;
94 
</pre>
 93 
</pre>
95 
<h4>C</h5>
 94 
<h4>C</h4>
96 
<pre>
 - 
 
97 
HRESULT __stdcall ReadAPIKeyW(LPWSTR key, BOOL DontShowErrors);
 95 
<pre>HRESULT __stdcall ReadAPIKeyW(LPWSTR key, BOOL DontShowErrors);
98 
HRESULT __stdcall ReadAPIKeyA(LPSTR key, BOOL DontShowErrors);
 96 
HRESULT __stdcall ReadAPIKeyA(LPSTR key, BOOL DontShowErrors);
99 
</pre>
 97 
</pre>
100 
 
 98 
 
101 
<h3>Description</h4>
 99 
<h3>Description</h3>
102 
<p>Reads the API key from the registry.</p>
 100 
<p>Reads the API key from the registry.</p>
103 
 
 101 
 
104 
<h3>Parameters</h4>
 102 
<h3>Parameters</h3>
105 
<ul>
 103 
<ul>
106 
        <li>key: A buffer where the 32 digit key will be written to. There should be at least 33 chars memory reserved (32 chars key + 1 char zero termination).</li>
 104 
        <li>key: A buffer where the 32 digit key will be written to. There should be at least 33 chars memory reserved (32 chars key + 1 char zero termination).</li>
107 
        <li>UserMode: If true, the API key will be written into <code>HKEY_LOCAL_USER</code>, otherwise it will be written to <code>HKEY_LOCAL_MACHINE</code>.</li>
 105 
        <li>UserMode: If true, the API key will be written into <code>HKEY_LOCAL_USER</code>, otherwise it will be written to <code>HKEY_LOCAL_MACHINE</code>.</li>
108 
        <li>DontShowErrors: If true, no errors will be displayed. If true, errors will result in a dialog box, in addition to the result code.</li>
 106 
        <li>DontShowErrors: If true, no errors will be displayed. If true, errors will result in a dialog box, in addition to the result code.</li>
109 
</ul>
 107 
</ul>
110 
 
 108 
 
111 
<h3>Returns</h4>
 109 
<h3>Returns</h3>
112 
<ul>
 110 
<ul>
113 
        <li>S_VTSCONV_OK (0x20000000) if the key could be successfully deleted.</li>
 111 
        <li>S_VTSCONV_OK (0x20000000) if the key could be successfully deleted.</li>
114 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured, e.g. if the registry is write protected.</li>
 112 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured, e.g. if the registry is write protected.</li>
115 
        <li>E_VTSCONV_STOREDKEY_INVALID (0xA0000002) if the key stored in the registry is invalid.</li>
 113 
        <li>E_VTSCONV_STOREDKEY_INVALID (0xA0000002) if the key stored in the registry is invalid.</li>
116 
        <li>E_VTSCONV_NO_STOREDKEY (0xA0000003) if there is no key stored in the registry.</li>
 114 
        <li>E_VTSCONV_NO_STOREDKEY (0xA0000003) if there is no key stored in the registry.</li>
117 
</ul>
 115 
</ul>
118 
 
 116 
 
119 
<h2 id="Convert">Convert</h3>
 117 
<h2 id="Convert">Convert</h2>
120 
 
 118 
 
121 
<h3>Syntax</h4>
 119 
<h3>Syntax</h3>
122 
<h4>Delphi</h5>
 120 
<h4>Delphi</h4>
123 
<pre>
 - 
 
124 
function Convert(Value: Double; CurFrom, CurTo: LPCTSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Double; stdcall;
 121 
<pre>function Convert(Value: Double; CurFrom, CurTo: LPCTSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Double; stdcall;
125 
function ConvertW(Value: Double; CurFrom, CurTo: LPCWSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Double; stdcall;
 122 
function ConvertW(Value: Double; CurFrom, CurTo: LPCWSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Double; stdcall;
126 
function ConvertA(Value: Double; CurFrom, CurTo: LPCSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Double; stdcall;
 123 
function ConvertA(Value: Double; CurFrom, CurTo: LPCSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Double; stdcall;
127 
</pre>
 124 
</pre>
128 
<h4>C</h5>
 125 
<h4>C</h4>
129 
<pre>
 - 
 
130 
double __stdcall ConvertW(double Value, LPCWSTR CurFrom, LPCWSTR CurTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
 126 
<pre>double __stdcall ConvertW(double Value, LPCWSTR CurFrom, LPCWSTR CurTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
131 
double __stdcall ConvertA(double Value, LPCSTR CurFrom, LPCSTR CurTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
 127 
double __stdcall ConvertA(double Value, LPCSTR CurFrom, LPCSTR CurTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
132 
</pre>
 128 
</pre>
133 
 
 129 
 
134 
<h3>Description</h4>
 130 
<h3>Description</h3>
135 
<p>Converts into a differnt currency.</p>
 131 
<p>Converts into a differnt currency.</p>
136 
 
 132 
 
137 
<h3>Parameters</h4>
 133 
<h3>Parameters</h3>
138 
<ul>
 134 
<ul>
139 
        <li>Value: The amount of money in the source currency you want to convert into the target currency.</li>
 135 
        <li>Value: The amount of money in the source currency you want to convert into the target currency.</li>
140 
        <li>CurFrom: The source currency, formatted as defined in ISO-4217 (3 chars, e.g. "USD")</li>
 136 
        <li>CurFrom: The source currency, formatted as defined in ISO-4217 (3 chars, e.g. "USD")</li>
141 
        <li>CurTo: The target currency, formatted as defined in ISO-4217 (3 chars, e.g. "USD")</li>
 137 
        <li>CurTo: The target currency, formatted as defined in ISO-4217 (3 chars, e.g. "USD")</li>
142 
        <li>MaxAge: Defines, after which amount of time the exchange data needs to be re-downloaded from the server.<ul>
 138 
        <li>MaxAge: Defines, after which amount of time the exchange data needs to be re-downloaded from the server.<ul>
143 
                <li>-1: Only download once</li>
 139 
                <li>-1: Only download once</li>
144 
                <li&gt;0: Always download, on each request (attention: API keys may have limited amount of accesses per month)</li>
 140 
                <li>0: Always download, on each request (attention: API keys may have limited amount of accesses per month)</li>
145 
                <li>&gt;0: Download after the supplied amount of time (in seconds)</li>
 141 
                <li>&gt;0: Download after the supplied amount of time (in seconds)</li>
146 
        </ul></li>
 142 
        </ul></li>
147 
        <li>Flags: Is a sum of following components:<ul>
 143 
        <li>Flags: Is a sum of following components:<ul>
148 
                <li>CONVERT_DONT_SHOW_ERRORS (1): Don't show errors in a dialog box.</li>
 144 
                <li>CONVERT_DONT_SHOW_ERRORS (1): Don't show errors in a dialog box.</li>
149 
                <li>CONVERT_FALLBACK_TO_CACHE (2): If download failed, use the previous downloaded cache file, even if it is older than MaxAge.</li>
 145 
                <li>CONVERT_FALLBACK_TO_CACHE (2): If download failed, use the previous downloaded cache file, even if it is older than MaxAge.</li>
Line 155... Line 151...
155 
                <li>0: Use the current exchange data</li>
 151 
                <li>0: Use the current exchange data</li>
156 
                <li>any valid DATE: use an historic exchange</li>
 152 
                <li>any valid DATE: use an historic exchange</li>
157 
        </ul></li>
 153 
        </ul></li>
158 
</ul>
 154 
</ul>
159 
 
 155 
 
160 
<h3>Returns</h4>
 156 
<h3>Returns</h3>
161 
<ul>
 157 
<ul>
162 
        <li>-1 if an error occured</li>
 158 
        <li>-1 if an error occured</li>
163 
        <li>&gt;=0 the amount of money in the target currency</li>
 159 
        <li>&gt;=0 the amount of money in the target currency</li>
164 
</ul>
 160 
</ul>
165 
 
 161 
 
166 
<h2 id="AcceptedCurrencies">AcceptedCurrencies</h3>
 162 
<h2 id="AcceptedCurrencies">AcceptedCurrencies</h2>
167 
 
 163 
 
168 
<h3>Syntax</h4>
 164 
<h3>Syntax</h3>
169 
<h4>Delphi</h5>
 165 
<h4>Delphi</h4>
170 
<pre>
 - 
 
171 
function AcceptedCurrencies(WriteTo: LPTSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Integer; stdcall;
 166 
<pre>function AcceptedCurrencies(WriteTo: LPTSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Integer; stdcall;
172 
function AcceptedCurrenciesW(WriteTo: LPWSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Integer; stdcall;
 167 
function AcceptedCurrenciesW(WriteTo: LPWSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Integer; stdcall;
173 
function AcceptedCurrenciesA(WriteTo: LPSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Integer; stdcall;
 168 
function AcceptedCurrenciesA(WriteTo: LPSTR; MaxAge: integer; Flags: TVtsCurConvFlags; HistoricDate: TDate): Integer; stdcall;
174 
</pre>
 169 
</pre>
175 
<h4>C</h5>
 170 
<h4>C</h4>
176 
<pre>
 - 
 
177 
int __stdcall AcceptedCurrenciesW(LPWSTR WriteTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
 171 
<pre>int __stdcall AcceptedCurrenciesW(LPWSTR WriteTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
178 
int __stdcall AcceptedCurrenciesA(LPSTR WriteTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
 172 
int __stdcall AcceptedCurrenciesA(LPSTR WriteTo, int MaxAge, CURCONV_FLAGS Flags, DATE HistoricDate);
179 
</pre>
 173 
</pre>
180 
 
 174 
 
181 
<h3>Description</h4>
 175 
<h3>Description</h3>
182 
<p>Shows a list of available currencies.</p>
 176 
<p>Shows a list of available currencies.</p>
183 
 
 177 
 
184 
<h3>Parameters</h4>
 178 
<h3>Parameters</h3>
185 
<ul>
 179 
<ul>
186 
        <li>WriteTo: A pointer to which the available currencies will be written to. Please reserve at least (NumOfCurrencies*3+1) characters of memory. To query how many currencies are available, please invoke the method once and set this parameter to NULL. All currencies will be appended in the format as defined in ISO-4217. Example: "USDEURCAD\0" will be a list of USD, EUR and CAD.</li>
 180 
        <li>WriteTo: A pointer to which the available currencies will be written to. Please reserve at least (NumOfCurrencies*3+1) characters of memory. To query how many currencies are available, please invoke the method once and set this parameter to NULL. All currencies will be appended in the format as defined in ISO-4217. Example: "USDEURCAD\0" will be a list of USD, EUR and CAD.</li>
187 
        <li>MaxAge: Defines, after which amount of time the exchange data needs to be re-downloaded from the server.<ul>
 181 
        <li>MaxAge: Defines, after which amount of time the exchange data needs to be re-downloaded from the server.<ul>
188 
                <li>-1: Only download once</li>
 182 
                <li>-1: Only download once</li>
189 
                <li&gt;0: Always download, on each request (attention: API keys may have limited amount of accesses per month)</li>
 183 
                <li>0: Always download, on each request (attention: API keys may have limited amount of accesses per month)</li>
190 
                <li>&gt;0: Download after the supplied amount of time (in seconds)</li>
 184 
                <li>&gt;0: Download after the supplied amount of time (in seconds)</li>
191 
        </ul></li>
 185 
        </ul></li>
192 
        <li>Flags: Is a sum of following components:<ul>
 186 
        <li>Flags: Is a sum of following components:<ul>
193 
                <li>CONVERT_DONT_SHOW_ERRORS (1): Don't show errors in a dialog box.</li>
 187 
                <li>CONVERT_DONT_SHOW_ERRORS (1): Don't show errors in a dialog box.</li>
194 
                <li>CONVERT_FALLBACK_TO_CACHE (2): If download failed, use the previous downloaded cache file, even if it is older than MaxAge.</li>
 188 
                <li>CONVERT_FALLBACK_TO_CACHE (2): If download failed, use the previous downloaded cache file, even if it is older than MaxAge.</li>
Line 200... Line 194...
200 
                <li>0: Use the current exchange data</li>
 194 
                <li>0: Use the current exchange data</li>
201 
                <li>any valid DATE: use an historic exchange</li>
 195 
                <li>any valid DATE: use an historic exchange</li>
202 
        </ul></li>
 196 
        </ul></li>
203 
</ul>
 197 
</ul>
204 
 
 198 
 
205 
<h3>Returns</h4>
 199 
<h3>Returns</h3>
206 
<ul>
 200 
<ul>
207 
        <li>-1 if an error occured</li>
 201 
        <li>-1 if an error occured</li>
208 
        <li>&gt;=0 the number of currencies found/written</li>
 202 
        <li>&gt;=0 the number of currencies found/written</li>
209 
</ul>
 203 
</ul>
210 
 
 204 
 
211 
<h2 id="DownloadNow">DownloadNow</h3>
 205 
<h2 id="DownloadNow">DownloadNow</h2>
212 
 
 206 
 
213 
<h3>Syntax</h4>
 207 
<h3>Syntax</h3>
214 
<h4>Delphi</h5>
 208 
<h4>Delphi</h4>
215 
<pre>
 - 
 
216 
function DownloadNow(Flags: TVtsCurConvFlags; HistoricDate: TDate): HRESULT; stdcall;
 209 
<pre>function DownloadNow(Flags: TVtsCurConvFlags; HistoricDate: TDate): HRESULT; stdcall;
217 
</pre>
 210 
</pre>
218 
<h4>C</h5>
 211 
<h4>C</h4>
219 
<pre>
 - 
 
220 
HRESULT __stdcall DownloadNow(CURCONV_FLAGS Flags, DATE HistoricDate);
 212 
<pre>HRESULT __stdcall DownloadNow(CURCONV_FLAGS Flags, DATE HistoricDate);
221 
</pre>
 213 
</pre>
222 
 
 214 
 
223 
<h3>Description</h4>
 215 
<h3>Description</h3>
224 
<p>Forces the framework to download the currency table.</p>
 216 
<p>Forces the framework to download the currency table.</p>
225 
 
 217 
 
226 
<h3>Parameters</h4>
 218 
<h3>Parameters</h3>
227 
<ul>
 219 
<ul>
228 
        <li>Flags: Is a sum of following components:<ul>
 220 
        <li>Flags: Is a sum of following components:<ul>
229 
                <li>CONVERT_DONT_SHOW_ERRORS (1): Don't show errors in a dialog box.</li>
 221 
                <li>CONVERT_DONT_SHOW_ERRORS (1): Don't show errors in a dialog box.</li>
230 
                <li>CONVERT_FALLBACK_TO_CACHE (2): If download failed, use the previous downloaded cache file, even if it is older than MaxAge.</li>
 222 
                <li>CONVERT_FALLBACK_TO_CACHE (2): If download failed, use the previous downloaded cache file, even if it is older than MaxAge.</li>
231 
                <li>CONVERT_USE_SSL (4): Use SSL to download the data. Note that only a paid subscription allows download via SSL.</li>
 223 
                <li>CONVERT_USE_SSL (4): Use SSL to download the data. Note that only a paid subscription allows download via SSL.</li>
Line 236... Line 228...
236 
                <li>0: Use the current exchange data</li>
 228 
                <li>0: Use the current exchange data</li>
237 
                <li>any valid DATE: use an historic exchange</li>
 229 
                <li>any valid DATE: use an historic exchange</li>
238 
        </ul></li>
 230 
        </ul></li>
239 
</ul>
 231 
</ul>
240 
 
 232 
 
241 
<h3>Returns</h4>
 233 
<h3>Returns</h3>
242 
<ul>
 234 
<ul>
243 
        <li>S_VTSCONV_OK (0x20000000) if the download was successful.</li>
 235 
        <li>S_VTSCONV_OK (0x20000000) if the download was successful.</li>
244 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured.</li>
 236 
        <li>E_VTSCONV_GENERIC_FAILURE (0xA0000000) if an error occured.</li>
245 
</ul>
 237 
</ul>
246 
 
 238 
 
- 
 
 239 
<hr>
- 
 
 240 
 
- 
 
 241 
<p><i>Last change: 27.08.2017</i></p>
- 
 
 242 
 
247 
</body>
 243 
</body>
248 
 
 244 
 
249 
</html>
 245 
</html>
250 

            246