include: Add IProvideRuntimeContext and a few annotations.
[wine] / include / fusion.idl
1 /*
2  * Copyright 2008 James Hawkins
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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
17  */
18
19 import "objidl.idl";
20
21 interface IAssemblyCache;
22 interface IAssemblyCacheItem;
23 interface IAssemblyEnum;
24 interface IAssemblyName;
25
26 typedef enum
27 {
28     ASM_CACHE_ZAP       = 0x1,
29     ASM_CACHE_GAC       = 0x2,
30     ASM_CACHE_DOWNLOAD  = 0x4,
31     ASM_CACHE_ROOT      = 0x8
32 } ASM_CACHE_FLAGS;
33
34 typedef enum
35 {
36     peNone      = 0x00000000,
37     peMSIL      = 0x00000001,
38     peI386      = 0x00000002,
39     peIA64      = 0x00000003,
40     peAMD64     = 0x00000004,
41     peInvalid   = 0xffffffff
42 } PEKIND;
43
44 typedef enum _tagAssemblyComparisonResult
45 {
46     ACR_Unknown,
47     ACR_EquivalentFullMatch,
48     ACR_EquivalentWeakNamed,
49     ACR_EquivalentFXUnified,
50     ACR_EquivalentUnified,
51     ACR_NonEquivalentVersion,
52     ACR_NonEquivalent,
53     ACR_EquivalentPartialMatch,
54     ACR_EquivalentPartialWeakNamed,
55     ACR_EquivalentPartialUnified,
56     ACR_EquivalentPartialFXUnified,
57     ACR_NonEquivalentPartialVersion
58 } AssemblyComparisonResult;
59
60 [
61     local,
62     object,
63     uuid(e707dcde-d1cd-11d2-bab9-00c04f8eceae),
64     pointer_default(unique)
65 ]
66 interface IAssemblyCache : IUnknown
67 {
68     typedef struct _FUSION_INSTALL_REFERENCE_
69     {
70         DWORD cbSize;
71         DWORD dwFlags;
72         GUID guidScheme;
73         LPCWSTR szIdentifier;
74         LPCWSTR szNonCannonicalData;
75     } FUSION_INSTALL_REFERENCE, *LPFUSION_INSTALL_REFERENCE;
76
77     typedef const FUSION_INSTALL_REFERENCE  *LPCFUSION_INSTALL_REFERENCE;
78
79     typedef struct _ASSEMBLY_INFO
80     {
81         ULONG cbAssemblyInfo;
82         DWORD dwAssemblyFlags;
83         ULARGE_INTEGER uliAssemblySizeInKB;
84         LPWSTR pszCurrentAssemblyPathBuf;
85         ULONG cchBuf;
86     } ASSEMBLY_INFO;
87
88     cpp_quote("#define IASSEMBLYCACHE_INSTALL_FLAG_REFRESH       0x00000001")
89     cpp_quote("#define IASSEMBLYCACHE_INSTALL_FLAG_FORCE_REFRESH 0x00000002")
90
91     cpp_quote("#define IASSEMBLYCACHE_UNINSTALL_DISPOSITION_UNINSTALLED 1")
92     cpp_quote("#define IASSEMBLYCACHE_UNINSTALL_DISPOSITION_STILL_IN_USE 2")
93     cpp_quote("#define IASSEMBLYCACHE_UNINSTALL_DISPOSITION_ALREADY_UNINSTALLED 3")
94     cpp_quote("#define IASSEMBLYCACHE_UNINSTALL_DISPOSITION_DELETE_PENDING 4")
95     cpp_quote("#define IASSEMBLYCACHE_UNINSTALL_DISPOSITION_HAS_INSTALL_REFERENCES 5")
96     cpp_quote("#define IASSEMBLYCACHE_UNINSTALL_DISPOSITION_REFERENCE_NOT_FOUND 6")
97
98     cpp_quote("#define QUERYASMINFO_FLAG_VALIDATE   0x00000001")
99     cpp_quote("#define QUERYASMINFO_FLAG_GETSIZE    0x00000002")
100
101     cpp_quote("#define ASSEMBLYINFO_FLAG_INSTALLED       0x00000001")
102     cpp_quote("#define ASSEMBLYINFO_FLAG_PAYLOADRESIDENT 0x00000002")
103
104     HRESULT UninstallAssembly(
105         [in] DWORD dwFlags,
106         [in] LPCWSTR pszAssemblyName,
107         [in] LPCFUSION_INSTALL_REFERENCE pRefData,
108         [out, optional] ULONG *pulDisposition);
109
110     HRESULT QueryAssemblyInfo(
111         [in] DWORD dwFlags,
112         [in] LPCWSTR pszAssemblyName,
113         [in, out] ASSEMBLY_INFO *pAsmInfo);
114
115     HRESULT CreateAssemblyCacheItem(
116         [in] DWORD dwFlags,
117         [in] PVOID pvReserved,
118         [out] IAssemblyCacheItem **ppAsmItem,
119         [in, optional] LPCWSTR pszAssemblyName);
120
121     HRESULT CreateAssemblyScavenger([out] IUnknown **ppUnkReserved);
122
123     HRESULT InstallAssembly(
124         [in] DWORD dwFlags,
125         [in] LPCWSTR pszManifestFilePath,
126         [in] LPCFUSION_INSTALL_REFERENCE pRefData);
127 }
128
129 [
130     local,
131     object,
132     uuid(9e3aaeb4-d1cd-11d2-bab9-00c04f8eceae),
133     pointer_default(unique)
134 ]
135 interface IAssemblyCacheItem : IUnknown
136 {
137     cpp_quote("#define STREAM_FORMAT_COMPLIB_MODULE    0")
138     cpp_quote("#define STREAM_FORMAT_COMPLIB_MANIFEST  1")
139     cpp_quote("#define STREAM_FORMAT_WIN32_MODULE      2")
140     cpp_quote("#define STREAM_FORMAT_WIN32_MANIFEST    4")
141
142     cpp_quote("#define IASSEMBLYCACHEITEM_COMMIT_FLAG_REFRESH       0x00000001")
143     cpp_quote("#define IASSEMBLYCACHEITEM_COMMIT_FLAG_FORCE_REFRESH 0x00000002")
144
145     cpp_quote("#define IASSEMBLYCACHEITEM_COMMIT_DISPOSITION_INSTALLED 1")
146     cpp_quote("#define IASSEMBLYCACHEITEM_COMMIT_DISPOSITION_REFRESHED 2")
147     cpp_quote("#define IASSEMBLYCACHEITEM_COMMIT_DISPOSITION_ALREADY_INSTALLED 3")
148
149     HRESULT CreateStream(
150         [in] DWORD dwFlags,
151         [in] LPCWSTR pszStreamName,
152         [in] DWORD dwFormat,
153         [in] DWORD dwFormatFlags,
154         [out] IStream **ppIStream,
155         [in, optional] ULARGE_INTEGER *puliMaxSize);
156
157     HRESULT Commit(
158         [in] DWORD dwFlags,
159         [out, optional] ULONG *pulDisposition);
160
161     HRESULT AbortItem();
162 }
163
164 [
165     local,
166     object,
167     uuid(CD193BC0-B4BC-11d2-9833-00C04FC31D2E),
168     pointer_default(unique)
169 ]
170 interface IAssemblyName: IUnknown
171 {
172     typedef [unique] IAssemblyName *LPASSEMBLYNAME;
173
174     typedef enum
175     {
176         CANOF_PARSE_DISPLAY_NAME = 0x1,
177         CANOF_SET_DEFAULT_VALUES = 0x2,
178         CANOF_VERIFY_FRIEND_ASSEMBLYNAME = 0x4,
179         CANOF_PARSE_FRIEND_DISPLAY_NAME = CANOF_PARSE_DISPLAY_NAME |
180                                           CANOF_VERIFY_FRIEND_ASSEMBLYNAME
181     } CREATE_ASM_NAME_OBJ_FLAGS;
182
183     typedef enum
184     {
185         ASM_NAME_PUBLIC_KEY = 0,
186         ASM_NAME_PUBLIC_KEY_TOKEN,
187         ASM_NAME_HASH_VALUE,
188         ASM_NAME_NAME,
189         ASM_NAME_MAJOR_VERSION,
190         ASM_NAME_MINOR_VERSION,
191         ASM_NAME_BUILD_NUMBER,
192         ASM_NAME_REVISION_NUMBER,
193         ASM_NAME_CULTURE,
194         ASM_NAME_PROCESSOR_ID_ARRAY,
195         ASM_NAME_OSINFO_ARRAY,
196         ASM_NAME_HASH_ALGID,
197         ASM_NAME_ALIAS,
198         ASM_NAME_CODEBASE_URL,
199         ASM_NAME_CODEBASE_LASTMOD,
200         ASM_NAME_NULL_PUBLIC_KEY,
201         ASM_NAME_NULL_PUBLIC_KEY_TOKEN,
202         ASM_NAME_CUSTOM,
203         ASM_NAME_NULL_CUSTOM,
204         ASM_NAME_MVID,
205         ASM_NAME_FILE_MAJOR_VERSION,
206         ASM_NAME_FILE_MINOR_VERSION,
207         ASM_NAME_FILE_BUILD_NUMBER,
208         ASM_NAME_FILE_REVISION_NUMBER,
209         ASM_NAME_RETARGET,
210         ASM_NAME_SIGNATURE_BLOB,
211         ASM_NAME_CONFIG_MASK,
212         ASM_NAME_ARCHITECTURE,
213         ASM_NAME_MAX_PARAMS
214     } ASM_NAME;
215
216     typedef enum
217     {
218         ASM_DISPLAYF_VERSION = 0x1,
219         ASM_DISPLAYF_CULTURE = 0x2,
220         ASM_DISPLAYF_PUBLIC_KEY_TOKEN = 0x4,
221         ASM_DISPLAYF_PUBLIC_KEY = 0x8,
222         ASM_DISPLAYF_CUSTOM = 0x10,
223         ASM_DISPLAYF_PROCESSORARCHITECTURE = 0x20,
224         ASM_DISPLAYF_LANGUAGEID = 0x40,
225         ASM_DISPLAYF_RETARGET = 0x80,
226         ASM_DISPLAYF_CONFIG_MASK = 0x100,
227         ASM_DISPLAYF_MVID = 0x200,
228
229         ASM_DISPLAYF_FULL = ASM_DISPLAYF_VERSION |
230                             ASM_DISPLAYF_CULTURE |
231                             ASM_DISPLAYF_PUBLIC_KEY_TOKEN |
232                             ASM_DISPLAYF_RETARGET |
233                             ASM_DISPLAYF_PROCESSORARCHITECTURE,
234     } ASM_DISPLAY_FLAGS;
235
236     typedef enum
237     {
238         ASM_CMPF_NAME               = 0x1,
239         ASM_CMPF_MAJOR_VERSION      = 0x2,
240         ASM_CMPF_MINOR_VERSION      = 0x4,
241         ASM_CMPF_BUILD_NUMBER       = 0x8,
242         ASM_CMPF_REVISION_NUMBER    = 0x10,
243         ASM_CMPF_VERSION = ASM_CMPF_MAJOR_VERSION |
244                            ASM_CMPF_MINOR_VERSION |
245                            ASM_CMPF_BUILD_NUMBER |
246                            ASM_CMPF_REVISION_NUMBER,
247         ASM_CMPF_PUBLIC_KEY_TOKEN   = 0x20,
248         ASM_CMPF_CULTURE            = 0x40,
249         ASM_CMPF_CUSTOM             = 0x80,
250         ASM_CMPF_DEFAULT            = 0x100,
251         ASM_CMPF_RETARGET           = 0x200,
252         ASM_CMPF_ARCHITECTURE       = 0x400,
253         ASM_CMPF_CONFIG_MASK        = 0x800,
254         ASM_CMPF_MVID               = 0x1000,
255         ASM_CMPF_SIGNATURE          = 0x2000,
256         ASM_CMPF_IL_ALL = ASM_CMPF_NAME |
257                           ASM_CMPF_VERSION |
258                           ASM_CMPF_PUBLIC_KEY_TOKEN |
259                           ASM_CMPF_CULTURE,
260         ASM_CMPF_IL_NO_VERSION = ASM_CMPF_NAME |
261                                  ASM_CMPF_PUBLIC_KEY_TOKEN |
262                                  ASM_CMPF_CULTURE
263     } ASM_CMP_FLAGS;
264
265     HRESULT SetProperty(
266         [in] DWORD PropertyId,
267         [in] LPVOID pvProperty,
268         [in] DWORD cbProperty);
269
270     HRESULT GetProperty(
271         [in] DWORD PropertyId,
272         [out] LPVOID pvProperty,
273         [in, out] LPDWORD pcbProperty);
274
275     HRESULT Finalize();
276
277     HRESULT GetDisplayName(
278         [out] LPOLESTR szDisplayName,
279         [in, out] LPDWORD pccDisplayName,
280         [in] DWORD dwDisplayFlags);
281
282     HRESULT Reserved(
283         [in] REFIID refIID,
284         [in] IUnknown *pUnkReserved1,
285         [in] IUnknown *pUnkReserved2,
286         [in] LPCOLESTR szReserved,
287         [in] LONGLONG llReserved,
288         [in] LPVOID pvReserved,
289         [in] DWORD cbReserved,
290         [out] LPVOID *ppReserved);
291
292     HRESULT GetName(
293         [in, out] LPDWORD lpcwBuffer,
294         [out] WCHAR *pwzName);
295
296     HRESULT GetVersion(
297         [out] LPDWORD pdwVersionHi,
298         [out] LPDWORD pdwVersionLow);
299
300     HRESULT IsEqual(
301         [in] IAssemblyName *pName,
302         [in] DWORD dwCmpFlags);
303
304     HRESULT Clone([out] IAssemblyName **pName);
305 }
306
307 [
308     local,
309     object,
310     uuid(21b8916c-f28e-11d2-a473-00c04f8ef448),
311     pointer_default(unique)
312 ]
313 interface IAssemblyEnum : IUnknown
314 {
315     HRESULT GetNextAssembly(
316         [in] LPVOID pvReserved,
317         [out] IAssemblyName **ppName,
318         [in] DWORD dwFlags);
319
320     HRESULT Reset(void);
321
322     HRESULT Clone([out] IAssemblyEnum **ppEnum);
323 }
324
325 [
326     local,
327     object,
328     uuid(582dac66-e678-449f-aba6-6faaec8a9394),
329     pointer_default(unique)
330 ]
331 interface IInstallReferenceItem : IUnknown
332 {
333
334 }
335
336 [
337     local,
338     object,
339     uuid(56b1a988-7c0c-4aa2-8639-c3eb5a90226f),
340     pointer_default(unique)
341 ]
342 interface IInstallReferenceEnum : IUnknown
343 {
344
345 }
346
347 cpp_quote("HRESULT WINAPI ClearDownloadCache(void);")
348 cpp_quote("HRESULT WINAPI CompareAssemblyIdentity(LPCWSTR,BOOL,LPCWSTR,BOOL,BOOL*,AssemblyComparisonResult*);")
349 cpp_quote("HRESULT WINAPI CreateAssemblyCache(IAssemblyCache**,DWORD);")
350 cpp_quote("HRESULT WINAPI CreateAssemblyEnum(IAssemblyEnum**,IUnknown*,IAssemblyName*,DWORD,LPVOID);")
351 cpp_quote("HRESULT WINAPI CreateAssemblyNameObject(LPASSEMBLYNAME*,LPCWSTR,DWORD,LPVOID);")
352 cpp_quote("HRESULT WINAPI CreateInstallReferenceEnum(IInstallReferenceEnum**,IAssemblyName*,DWORD,LPVOID);")
353 cpp_quote("HRESULT WINAPI GetAssemblyIdentityFromFile(LPCWSTR,REFIID,IUnknown**);")
354 cpp_quote("HRESULT WINAPI GetCachePath(ASM_CACHE_FLAGS,LPWSTR,PDWORD);")