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);")