include/comcat.idl

   1 /*
   2  * Copyright 2002 John K. Hohm
   3  * Copyright 2003 Alexandre Julliard
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2.1 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  18  */
  19
  20 import "unknwn.idl";
  21
  22 /*****************************************************************************
  23  * Types
  24  */
  25 typedef GUID CATID;
  26 typedef REFGUID REFCATID;
  27 cpp_quote("#define CATID_NULL GUID_NULL")
  28 cpp_quote("#define IsEqualCATID(rcatid1, rcatid2) IsEqualGUID(rcatid1, rcatid2)")
  29
  30 /*****************************************************************************
  31  * Aliases for EnumGUID
  32  */
  33 #define IEnumCATID IEnumGUID
  34 cpp_quote("#define IEnumCATID IEnumGUID")
  35 cpp_quote("#define IID_IEnumCATID IID_IEnumGUID")
  36 cpp_quote("#define LPENUMCATID LPENUMGUID")
  37 #define IEnumCLSID IEnumGUID
  38 cpp_quote("#define IEnumCLSID IEnumGUID")
  39 cpp_quote("#define IID_IEnumCLSID IID_IEnumGUID")
  40 cpp_quote("#define LPENUMCLSID LPENUMGUID")
  41
  42
  43 /*****************************************************************************
  44  * IEnumGUID
  45  */
  46 [
  47     object,
  48     uuid(0002e000-0000-0000-c000-000000000046),
  49     pointer_default(unique)
  50 ]
  51 interface IEnumGUID : IUnknown
  52 {
  53     typedef [unique] IEnumGUID *LPENUMGUID;
  54
  55     HRESULT Next(
  56         [in] ULONG celt,
  57         [out, size_is(celt), length_is(*pceltFetched)] GUID *rgelt,
  58         [out] ULONG *pceltFetched);
  59
  60     HRESULT Skip(
  61         [in] ULONG celt);
  62
  63     HRESULT Reset();
  64
  65     HRESULT Clone(
  66         [out] IEnumGUID **ppenum);
  67 }
  68
  69
  70 /*****************************************************************************
  71  * IEnumCATEGORYINFO
  72  */
  73 [
  74     object,
  75     uuid(0002e011-0000-0000-c000-000000000046),
  76     pointer_default(unique)
  77 ]
  78 interface IEnumCATEGORYINFO : IUnknown
  79 {
  80     typedef [unique] IEnumCATEGORYINFO *LPENUMCATEGORYINFO;
  81
  82     typedef struct tagCATEGORYINFO
  83     {
  84         CATID   catid;              /* category identifier for component */
  85         LCID    lcid;               /* locale identifier */
  86         OLECHAR szDescription[128]; /* description of the category */
  87     } CATEGORYINFO, *LPCATEGORYINFO;
  88
  89     HRESULT Next(
  90         [in] ULONG celt,
  91         [out, size_is(celt), length_is(*pceltFetched)] CATEGORYINFO* rgelt,
  92         [out] ULONG* pceltFetched);
  93
  94     HRESULT Skip(
  95         [in] ULONG celt);
  96
  97     HRESULT Reset();
  98
  99     HRESULT Clone(
 100         [out] IEnumCATEGORYINFO** ppenum);
 101 }
 102
 103
 104 /*****************************************************************************
 105  * ICatInformation
 106  */
 107 [
 108     object,
 109     uuid(0002e013-0000-0000-c000-000000000046),
 110     pointer_default(unique)
 111 ]
 112 interface ICatInformation : IUnknown
 113 {
 114     typedef [unique] ICatInformation* LPCATINFORMATION;
 115
 116     HRESULT EnumCategories(
 117         [in] LCID lcid,
 118         [out] IEnumCATEGORYINFO** ppenumCategoryInfo);
 119
 120     HRESULT GetCategoryDesc(
 121         [in] REFCATID rcatid,
 122         [in] LCID lcid,
 123         [out] LPWSTR* pszDesc);
 124
 125     [local]
 126     HRESULT EnumClassesOfCategories(
 127         [in] ULONG cImplemented,
 128         [in,size_is(cImplemented)] CATID rgcatidImpl[],
 129         [in] ULONG cRequired,
 130         [in,size_is(cRequired)] CATID rgcatidReq[],
 131         [out] IEnumCLSID** ppenumClsid);
 132
 133     [call_as(EnumClassesOfCategories)]
 134     HRESULT RemoteEnumClassesOfCategories(
 135         [in] ULONG cImplemented,
 136         [in,unique,size_is(cImplemented)] CATID rgcatidImpl[],
 137         [in] ULONG cRequired,
 138         [in,unique,size_is(cRequired)] CATID rgcatidReq[],
 139         [out] IEnumCLSID** ppenumClsid);
 140
 141     [local]
 142     HRESULT IsClassOfCategories(
 143         [in] REFCLSID rclsid,
 144         [in] ULONG cImplemented,
 145         [in,size_is(cImplemented)] CATID rgcatidImpl[],
 146         [in] ULONG cRequired,
 147         [in,size_is(cRequired)] CATID rgcatidReq[]);
 148
 149     [call_as(IsClassOfCategories)]
 150     HRESULT RemoteIsClassOfCategories(
 151         [in] REFCLSID rclsid,
 152         [in] ULONG cImplemented,
 153         [in,unique,size_is(cImplemented)] CATID rgcatidImpl[],
 154         [in] ULONG cRequired,
 155         [in,unique,size_is(cRequired)] CATID rgcatidReq[] );
 156
 157     HRESULT EnumImplCategoriesOfClass(
 158         [in] REFCLSID rclsid,
 159         [out] IEnumCATID** ppenumCatid);
 160
 161     HRESULT EnumReqCategoriesOfClass(
 162         [in] REFCLSID rclsid,
 163         [out] IEnumCATID** ppenumCatid);
 164 }
 165
 166
 167 /*****************************************************************************
 168  * ICatRegister
 169  */
 170 [
 171     object,
 172     uuid(0002e012-0000-0000-c000-000000000046),
 173     pointer_default(unique)
 174 ]
 175 interface ICatRegister : IUnknown
 176 {
 177     typedef [unique] ICatRegister* LPCATREGISTER;
 178
 179     HRESULT RegisterCategories(
 180         [in] ULONG cCategories,
 181         [in, size_is(cCategories)] CATEGORYINFO rgCategoryInfo[]);
 182
 183     HRESULT UnRegisterCategories(
 184         [in] ULONG cCategories,
 185         [in, size_is(cCategories)] CATID rgcatid[]);
 186
 187     HRESULT RegisterClassImplCategories(
 188         [in] REFCLSID rclsid,
 189         [in] ULONG cCategories,
 190         [in, size_is(cCategories)] CATID rgcatid[]);
 191
 192     HRESULT UnRegisterClassImplCategories(
 193         [in] REFCLSID rclsid,
 194         [in] ULONG cCategories,
 195         [in, size_is(cCategories)] CATID rgcatid[]);
 196
 197     HRESULT RegisterClassReqCategories(
 198         [in] REFCLSID rclsid,
 199         [in] ULONG cCategories,
 200         [in, size_is(cCategories)] CATID rgcatid[]);
 201
 202     HRESULT UnRegisterClassReqCategories(
 203         [in] REFCLSID rclsid,
 204         [in] ULONG cCategories,
 205         [in, size_is(cCategories)] CATID rgcatid[]);
 206 }
 207
 208
 209 /*****************************************************************************
 210  * Category IDs
 211  */
 212 cpp_quote("DEFINE_GUID( CATID_Insertable, 0x40fc6ed3, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 213 cpp_quote("DEFINE_GUID( CATID_Control, 0x40fc6ed4, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 214 cpp_quote("DEFINE_GUID( CATID_Programmable, 0x40fc6ed5, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 215 cpp_quote("DEFINE_GUID( CATID_IsShortcut, 0x40fc6ed6, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 216 cpp_quote("DEFINE_GUID( CATID_NeverShowExt, 0x40fc6ed7, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 217 cpp_quote("DEFINE_GUID( CATID_DocObject, 0x40fc6ed8, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 218 cpp_quote("DEFINE_GUID( CATID_Printable, 0x40fc6ed9, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 219 cpp_quote("DEFINE_GUID( CATID_RequiresDataPathHost, 0x0de86a50, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 220 cpp_quote("DEFINE_GUID( CATID_PersistsToMoniker, 0x0de86a51, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 221 cpp_quote("DEFINE_GUID( CATID_PersistsToStorage, 0x0de86a52, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 222 cpp_quote("DEFINE_GUID( CATID_PersistsToStreamInit, 0x0de86a53, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 223 cpp_quote("DEFINE_GUID( CATID_PersistsToStream, 0x0de86a54, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 224 cpp_quote("DEFINE_GUID( CATID_PersistsToMemory, 0x0de86a55, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 225 cpp_quote("DEFINE_GUID( CATID_PersistsToFile, 0x0de86a56, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 226 cpp_quote("DEFINE_GUID( CATID_PersistsToPropertyBag, 0x0de86a57, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 227 cpp_quote("DEFINE_GUID( CATID_InternetAware, 0x0de86a58, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 228 cpp_quote("DEFINE_GUID( CATID_DesignTimeUIActivatableControl, 0xf2bb56d1, 0xdb07, 0x11d1, 0xaa, 0x6b, 0x00, 0x60, 0x97, 0xdb, 0x95, 0x39);")
 229 /* The Component Category Manager */
 230 cpp_quote("DEFINE_GUID(CLSID_StdComponentCategoriesMgr, 0x0002e005, 0x00, 0x00, 0xc0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);")