Add description for ExtTextOut (also include comments from Shachar
[wine] / include / msi.h
1 /*
2  * Copyright (C) 2002,2003 Mike McCormack
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17  */
18
19 #ifndef __WINE_MSI_H
20 #define __WINE_MSI_H
21
22 #ifdef __cplusplus
23 extern "C" {
24 #endif
25
26 typedef unsigned long MSIHANDLE;
27
28 typedef enum tagINSTALLSTATE
29 {
30     INSTALLSTATE_BADCONFIG = -6,
31     INSTALLSTATE_INCOMPLETE = -5,
32     INSTALLSTATE_SOURCEABSENT = -4,
33     INSTALLSTATE_MOREDATA = -3,
34     INSTALLSTATE_INVALIDARG = -2,
35     INSTALLSTATE_UNKNOWN = -1,
36     INSTALLSTATE_BROKEN = 0,
37     INSTALLSTATE_ADVERTISED = 1,
38     INSTALLSTATE_ABSENT = 2,
39     INSTALLSTATE_LOCAL = 3,
40     INSTALLSTATE_SOURCE = 4,
41     INSTALLSTATE_DEFAULT = 5
42 } INSTALLSTATE;
43
44 typedef enum tagINSTALLUILEVEL
45 {
46     INSTALLUILEVEL_NOCHANGE = 0,
47     INSTALLUILEVEL_DEFAULT = 1,
48     INSTALLUILEVEL_NONE = 2,
49     INSTALLUILEVEL_BASIC = 3,
50     INSTALLUILEVEL_REDUCED = 4,
51     INSTALLUILEVEL_FULL = 5,
52     INSTALLUILEVEL_HIDECANCEL = 0x20,
53     INSTALLUILEVEL_PROGRESSONLY = 0x40,
54     INSTALLUILEVEL_ENDDIALOG = 0x80,
55     INSTALLUILEVEL_SOURCERESONLY = 0x100
56 } INSTALLUILEVEL;
57
58 typedef enum tagINSTALLLEVEL
59 {
60     INSTALLLEVEL_DEFAULT = 0,
61     INSTALLLEVEL_MINIMUM = 1,
62     INSTALLLEVEL_MAXIMUM = 0xFFFF
63 } INSTALLLEVEL;
64
65 typedef enum tagINSTALLMESSAGE
66 {
67     INSTALLMESSAGE_FATALEXIT = 0,
68     INSTALLMESSAGE_ERROR = 0x01000000,
69     INSTALLMESSAGE_WARNING = 0x02000000,
70     INSTALLMESSAGE_USER = 0x03000000,
71     INSTALLMESSAGE_INFO = 0x04000000,
72     INSTALLMESSAGE_FILESINUSE = 0x05000000,
73     INSTALLMESSAGE_RESOLVESOURCE = 0x06000000,
74     INSTALLMESSAGE_OUTOFDISKSPACE = 0x07000000,
75     INSTALLMESSAGE_ACTIONSTART = 0x08000000,
76     INSTALLMESSAGE_ACTIONDATA = 0x09000000,
77     INSTALLMESSAGE_PROGRESS = 0x0a000000,
78     INSTALLMESSAGE_COMMONDATA = 0x0b000000,
79     INSTALLMESSAGE_INITIALIZE = 0x0c000000,
80     INSTALLMESSAGE_TERMINATE = 0x0d000000,
81     INSTALLMESSAGE_SHOWDIALOG = 0x0e000000
82 } INSTALLMESSAGE;
83
84 typedef enum tagREINSTALLMODE
85 {
86     REINSTALLMODE_REPAIR = 0x00000001,
87     REINSTALLMODE_FILEMISSING = 0x00000002,
88     REINSTALLMODE_FILEOLDERVERSION = 0x00000004,
89     REINSTALLMODE_FILEEQUALVERSION = 0x00000008,
90     REINSTALLMODE_FILEEXACT = 0x00000010,
91     REINSTALLMODE_FILEVERIFY = 0x00000020,
92     REINSTALLMODE_FILEREPLACE = 0x00000040,
93     REINSTALLMODE_MACHINEDATA = 0x00000080,
94     REINSTALLMODE_USERDATA = 0x00000100,
95     REINSTALLMODE_SHORTCUT = 0x00000200,
96     REINSTALLMODE_PACKAGE = 0x00000400
97 } REINSTALLMODE;
98
99 typedef enum tagINSTALLLOGMODE
100 {
101     INSTALLLOGMODE_FATALEXIT      = (1 << (INSTALLMESSAGE_FATALEXIT >> 24)),
102     INSTALLLOGMODE_ERROR          = (1 << (INSTALLMESSAGE_ERROR >> 24)),
103     INSTALLLOGMODE_WARNING        = (1 << (INSTALLMESSAGE_WARNING >> 24)),
104     INSTALLLOGMODE_USER           = (1 << (INSTALLMESSAGE_USER >> 24)),
105     INSTALLLOGMODE_INFO           = (1 << (INSTALLMESSAGE_INFO >> 24)),
106     INSTALLLOGMODE_RESOLVESOURCE  = (1 << (INSTALLMESSAGE_RESOLVESOURCE >> 24)),
107     INSTALLLOGMODE_OUTOFDISKSPACE = (1 << (INSTALLMESSAGE_OUTOFDISKSPACE >> 24)),
108     INSTALLLOGMODE_ACTIONSTART    = (1 << (INSTALLMESSAGE_ACTIONSTART >> 24)),
109     INSTALLLOGMODE_ACTIONDATA     = (1 << (INSTALLMESSAGE_ACTIONDATA >> 24)),
110     INSTALLLOGMODE_COMMONDATA     = (1 << (INSTALLMESSAGE_COMMONDATA >> 24)),
111     INSTALLLOGMODE_PROPERTYDUMP   = (1 << (INSTALLMESSAGE_PROGRESS >> 24)),
112     INSTALLLOGMODE_VERBOSE        = (1 << (INSTALLMESSAGE_INITIALIZE >> 24)),
113     INSTALLLOGMODE_EXTRADEBUG     = (1 << (INSTALLMESSAGE_TERMINATE >> 24)),
114     INSTALLLOGMODE_PROGRESS       = (1 << (INSTALLMESSAGE_PROGRESS >> 24)),
115     INSTALLLOGMODE_INITIALIZE     = (1 << (INSTALLMESSAGE_INITIALIZE >> 24)),
116     INSTALLLOGMODE_TERMINATE      = (1 << (INSTALLMESSAGE_TERMINATE >> 24)),
117     INSTALLLOGMODE_SHOWDIALOG     = (1 << (INSTALLMESSAGE_SHOWDIALOG >> 24))
118 } INSTALLLOGMODE;
119
120 typedef enum tagINSTALLLOGATTRIBUTES
121 {
122     INSTALLLOGATTRIBUTES_APPEND = 0x00000001,
123     INSTALLLOGATTRIBUTES_FLUSHEACHLINE = 0x00000002
124 } INSTALLLOGATTRIBUTES;
125
126 typedef enum tagADVERTISEFLAGS
127 {
128     ADVERTISEFLAGS_MACHINEASSIGN = 0,
129     ADVERTISEFLAGS_USERASSIGN = 1
130 } ADVERTISEFLAGS;
131
132 typedef enum tagINSTALLTYPE
133 {
134     INSTALLTYPE_DEFAULT = 0,
135     INSTALLTYPE_NETWORK_IMAGE = 1
136 } INSTALLTYPE;
137
138 #define MAX_FEATURE_CHARS 38
139
140 typedef INT (CALLBACK *INSTALLUI_HANDLERA)(LPVOID, UINT, LPCSTR);
141 typedef INT (CALLBACK *INSTALLUI_HANDLERW)(LPVOID, UINT, LPCWSTR);
142
143 UINT WINAPI MsiAdvertiseProductA(LPCSTR, LPCSTR, LPCSTR, LANGID);
144 UINT WINAPI MsiAdvertiseProductW(LPCWSTR, LPCWSTR, LPCWSTR, LANGID);
145 #define     MsiAdvertiseProduct WINELIB_NAME_AW(MsiAdvertiseProduct)
146
147 UINT WINAPI MsiInstallProductA(LPCSTR, LPCSTR);
148 UINT WINAPI MsiInstallProductW(LPCWSTR, LPCWSTR);
149 #define     MsiInstallProduct WINELIB_NAME_AW(MsiInstallProduct)
150
151 UINT WINAPI MsiReinstallProductA(LPCSTR, DWORD);
152 UINT WINAPI MsiReinstallProductW(LPCWSTR, DWORD);
153 #define     MsiReinstallProduct WINELIB_NAME_AW(MsiReinstallProduct)
154
155 UINT WINAPI MsiApplyPatchA(LPCSTR, LPCSTR, INSTALLTYPE, LPCSTR);
156 UINT WINAPI MsiApplyPatchW(LPCWSTR, LPCWSTR, INSTALLTYPE, LPCWSTR);
157 #define     MsiApplyPatch WINELIB_NAME_AW(MsiApplyPatch)
158
159 UINT WINAPI MsiEnumProductsA(DWORD index, LPSTR lpguid);
160 UINT WINAPI MsiEnumProductsW(DWORD index, LPWSTR lpguid);
161 #define     MsiEnumProducts WINELIB_NAME_AW(MsiEnumProducts)
162
163 UINT WINAPI MsiEnumFeaturesA(LPCSTR, DWORD, LPSTR, LPSTR);
164 UINT WINAPI MsiEnumFeaturesW(LPCWSTR, DWORD, LPWSTR, LPWSTR);
165 #define     MsiEnumFeatures WINELIB_NAME_AW(MsiEnumFeatures)
166
167 UINT WINAPI MsiEnumComponentsA(DWORD, LPSTR);
168 UINT WINAPI MsiEnumComponentsW(DWORD, LPWSTR);
169 #define     MsiEnumComponents WINELIB_NAME_AW(MsiEnumComponents)
170
171 UINT WINAPI MsiEnumClientsA(LPCSTR, DWORD, LPSTR);
172 UINT WINAPI MsiEnumClientsW(LPCWSTR, DWORD, LPWSTR);
173 #define     MsiEnumClients WINELIB_NAME_AW(MsiEnumClients)
174
175 UINT WINAPI MsiOpenDatabaseA(LPCSTR, LPCSTR, MSIHANDLE *);
176 UINT WINAPI MsiOpenDatabaseW(LPCWSTR, LPCWSTR, MSIHANDLE *);
177 #define     MsiOpenDatabase WINELIB_NAME_AW(MsiOpenDatabase)
178
179 UINT WINAPI MsiOpenPackageA(LPCSTR, MSIHANDLE*);
180 UINT WINAPI MsiOpenPackageW(LPCWSTR, MSIHANDLE*);
181 #define     MsiOpenPackage WINELIB_NAME_AW(MsiOpenPackage)
182
183 UINT WINAPI MsiOpenPackageExA(LPCSTR, DWORD, MSIHANDLE*);
184 UINT WINAPI MsiOpenPackageExW(LPCWSTR, DWORD, MSIHANDLE*);
185 #define     MsiOpenPackageEx WINELIB_NAME_AW(MsiOpenPackageEx)
186
187 UINT WINAPI MsiOpenProductA(LPCSTR, MSIHANDLE*);
188 UINT WINAPI MsiOpenProductW(LPCWSTR, MSIHANDLE*);
189 #define     MsiOpenProduct WINELIB_NAME_AW(MsiOpenProduct)
190
191 UINT WINAPI MsiGetSummaryInformationA(MSIHANDLE, LPCSTR, UINT, MSIHANDLE *);
192 UINT WINAPI MsiGetSummaryInformationW(MSIHANDLE, LPCWSTR, UINT, MSIHANDLE *);
193 #define     MsiGetSummaryInformation WINELIB_NAME_AW(MsiGetSummaryInformation)
194
195 UINT WINAPI MsiSummaryInfoGetPropertyA(MSIHANDLE,UINT,UINT*,INT*,FILETIME*,LPSTR,DWORD*);
196 UINT WINAPI MsiSummaryInfoGetPropertyW(MSIHANDLE,UINT,UINT*,INT*,FILETIME*,LPWSTR,DWORD*);
197 #define     MsiSummaryInfoGetProperty WINELIB_NAME_AW(MsiSummaryInfoGetProperty)
198
199 UINT WINAPI MsiProvideComponentFromDescriptorA(LPCSTR,LPSTR,DWORD*,DWORD*);
200 UINT WINAPI MsiProvideComponentFromDescriptorW(LPCWSTR,LPWSTR,DWORD*,DWORD*);
201 #define     MsiProvideComponentFromDescriptor WINELIB_NAME_AW(MsiProvideComponentFromDescriptor)
202
203 UINT WINAPI MsiGetProductPropertyA(MSIHANDLE,LPCSTR,LPSTR,DWORD*);
204 UINT WINAPI MsiGetProductPropertyW(MSIHANDLE,LPCWSTR,LPWSTR,DWORD*);
205 #define     MsiGetProductProperty WINELIB_NAME_AW(MsiGetProductProperty)
206
207 UINT WINAPI MsiGetPropertyA(MSIHANDLE, LPCSTR, LPSTR, DWORD*);
208 UINT WINAPI MsiGetPropertyW(MSIHANDLE, LPCWSTR, LPWSTR, DWORD*);
209 #define     MsiGetProperty WINELIB_NAME_AW(MsiGetProperty)
210
211 UINT WINAPI MsiVerifyPackageA(LPCSTR);
212 UINT WINAPI MsiVerifyPackageW(LPCWSTR);
213 #define     MsiVerifyPackage WINELIB_NAME_AW(MsiVerifyPackage)
214
215 INSTALLSTATE WINAPI MsiQueryProductStateA(LPCSTR);
216 INSTALLSTATE WINAPI MsiQueryProductStateW(LPCWSTR);
217 #define      MsiQueryProductState WINELIB_NAME_AW(MsiQueryProductState)
218
219 UINT WINAPI MsiConfigureProductA(LPCSTR, int, INSTALLSTATE);
220 UINT WINAPI MsiConfigureProductW(LPCWSTR, int, INSTALLSTATE);
221 #define     MsiConfigureProduct WINELIB_NAME_AW(MsiConfigureProduct);
222
223 UINT WINAPI MsiGetProductCodeA(LPCSTR, LPSTR);
224 UINT WINAPI MsiGetProductCodeW(LPCWSTR, LPWSTR);
225 #define     MsiGetProductCode WINELIB_NAME_AW(MsiGetProductCode)
226
227 UINT WINAPI MsiGetProductInfoA(LPCSTR, LPCSTR, LPSTR, DWORD *);
228 UINT WINAPI MsiGetProductInfoW(LPCWSTR, LPCWSTR, LPWSTR, DWORD *);
229 #define     MsiGetProductInfo WINELIB_NAME_AW(MsiGetProductInfo)
230
231 UINT WINAPI MsiEnableLogA(DWORD, LPCSTR, DWORD);
232 UINT WINAPI MsiEnableLogW(DWORD, LPCWSTR, DWORD);
233 #define     MsiEnableLog WINELIB_NAME_AW(MsiEnableLog)
234
235 INSTALLUI_HANDLERA WINAPI MsiSetExternalUIA(INSTALLUI_HANDLERA, DWORD, LPVOID);
236 INSTALLUI_HANDLERW WINAPI MsiSetExternalUIW(INSTALLUI_HANDLERW, DWORD, LPVOID);
237 #define MsiSetExternalUI WINELIB_NAME_AW(MsiSetExternalUI)
238
239 INSTALLSTATE WINAPI MsiGetComponentPathA(LPCSTR, LPCSTR, LPSTR, DWORD*);
240 INSTALLSTATE WINAPI MsiGetComponentPathW(LPCWSTR, LPCWSTR, LPWSTR, DWORD*);
241 #define MsiGetComponentPath WINELIB_NAME_AW(MsiGetComponentPath)
242
243 INSTALLSTATE WINAPI MsiQueryFeatureStateA(LPCSTR, LPCSTR);
244 INSTALLSTATE WINAPI MsiQueryFeatureStateW(LPCWSTR, LPCWSTR);
245 #define MsiQueryFeatureState WINELIB_NAME_AW(MsiQueryFeatureState)
246
247 UINT WINAPI MsiGetFeatureUsageA(LPCSTR, LPCSTR, DWORD*, WORD*);
248 UINT WINAPI MsiGetFeatureUsageW(LPCWSTR, LPCWSTR, DWORD*, WORD*);
249 #define MsiGetFeatureUsage WINELIB_NAME_AW(MsiGetFeatureUsage)
250
251 UINT WINAPI MsiEnumRelatedProductsA(LPCSTR, DWORD, DWORD, LPSTR);
252 UINT WINAPI MsiEnumRelatedProductsW(LPCWSTR, DWORD, DWORD, LPWSTR);
253 #define MsiEnumRelatedProducts WINELIB_NAME_AW(MsiEnumRelatedProducts)
254
255 UINT WINAPI MsiProvideAssemblyA(LPCSTR, LPCSTR, DWORD, DWORD, LPSTR, DWORD*);
256 UINT WINAPI MsiProvideAssemblyW(LPCWSTR, LPCWSTR, DWORD, DWORD, LPWSTR, DWORD*);
257 #define MsiProvideAssembly WINELIB_NAME_AW(MsiProvideAssembly)
258
259 UINT WINAPI MsiEnumComponentQualifiersA(LPSTR, DWORD, LPSTR, DWORD*, LPSTR, DWORD*);
260 UINT WINAPI MsiEnumComponentQualifiersW(LPWSTR, DWORD, LPWSTR, DWORD*, LPWSTR, DWORD*);
261 #define MsiEnumComponentQualifiers WINELIB_NAME_AW(MsiEnumComponentQualifiers)
262
263 UINT WINAPI MsiGetFileVersionA(LPCSTR, LPSTR, DWORD*, LPSTR, DWORD*);
264 UINT WINAPI MsiGetFileVersionW(LPCWSTR, LPWSTR, DWORD*, LPWSTR, DWORD*);
265 #define MsiGetFileVersion WINELIB_NAME_AW(MsiGetFileVersion)
266
267 /* Non Unicode */
268 UINT WINAPI MsiCloseHandle(MSIHANDLE);
269 UINT WINAPI MsiCloseAllHandles(void);
270 INSTALLUILEVEL WINAPI MsiSetInternalUI(INSTALLUILEVEL, HWND*);
271
272 #ifdef __cplusplus
273 }
274 #endif
275
276 #endif /* __WINE_MSI_H */