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