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 #ifndef DO_NO_IMPORTS
  21 import "unknwn.idl";
  22 #endif
  23
  24 /*****************************************************************************
  25  * Types
  26  */
  27 typedef GUID CATID;
  28 typedef REFGUID REFCATID;
  29 cpp_quote("#define CATID_NULL GUID_NULL")
  30 cpp_quote("#define IsEqualCATID(rcatid1, rcatid2) IsEqualGUID(rcatid1, rcatid2)")
  31
  32 /*****************************************************************************
  33  * Aliases for EnumGUID
  34  */
  35 #define IEnumCATID IEnumGUID
  36 cpp_quote("#define IEnumCATID IEnumGUID")
  37 cpp_quote("#define IID_IEnumCATID IID_IEnumGUID")
  38 cpp_quote("#define LPENUMCATID LPENUMGUID")
  39 #define IEnumCLSID IEnumGUID
  40 cpp_quote("#define IEnumCLSID IEnumGUID")
  41 cpp_quote("#define IID_IEnumCLSID IID_IEnumGUID")
  42 cpp_quote("#define LPENUMCLSID LPENUMGUID")
  43
  44
  45 /*****************************************************************************
  46  * IEnumGUID
  47  */
  48 [
  49     object,
  50     uuid(0002e000-0000-0000-c000-000000000046),
  51     pointer_default(unique)
  52 ]
  53 interface IEnumGUID : IUnknown
  54 {
  55     typedef [unique] IEnumGUID *LPENUMGUID;
  56
  57     HRESULT Next(
  58         [in] ULONG celt,
  59         [out, size_is(celt), length_is(*pceltFetched)] GUID *rgelt,
  60         [out] ULONG *pceltFetched);
  61
  62     HRESULT Skip(
  63         [in] ULONG celt);
  64
  65     HRESULT Reset();
  66
  67     HRESULT Clone(
  68         [out] IEnumGUID **ppenum);
  69 }
  70
  71
  72 /*****************************************************************************
  73  * IEnumCATEGORYINFO
  74  */
  75 [
  76     object,
  77     uuid(0002e011-0000-0000-c000-000000000046),
  78     pointer_default(unique)
  79 ]
  80 interface IEnumCATEGORYINFO : IUnknown
  81 {
  82     typedef [unique] IEnumCATEGORYINFO *LPENUMCATEGORYINFO;
  83
  84     typedef struct tagCATEGORYINFO
  85     {
  86         CATID   catid;              /* category identifier for component */
  87         LCID    lcid;               /* locale identifier */
  88         OLECHAR szDescription[128]; /* description of the category */
  89     } CATEGORYINFO, *LPCATEGORYINFO;
  90
  91     HRESULT Next(
  92         [in] ULONG celt,
  93         [out, size_is(celt), length_is(*pceltFetched)] CATEGORYINFO* rgelt,
  94         [out] ULONG* pceltFetched);
  95
  96     HRESULT Skip(
  97         [in] ULONG celt);
  98
  99     HRESULT Reset();
 100
 101     HRESULT Clone(
 102         [out] IEnumCATEGORYINFO** ppenum);
 103 }
 104
 105
 106 /*****************************************************************************
 107  * ICatInformation
 108  */
 109 [
 110     object,
 111     uuid(0002e013-0000-0000-c000-000000000046),
 112     pointer_default(unique)
 113 ]
 114 interface ICatInformation : IUnknown
 115 {
 116     typedef [unique] ICatInformation* LPCATINFORMATION;
 117
 118     HRESULT EnumCategories(
 119         [in] LCID lcid,
 120         [out] IEnumCATEGORYINFO** ppenumCategoryInfo);
 121
 122     HRESULT GetCategoryDesc(
 123         [in] REFCATID rcatid,
 124         [in] LCID lcid,
 125         [out] LPWSTR* pszDesc);
 126
 127     [local]
 128     HRESULT EnumClassesOfCategories(
 129         [in] ULONG cImplemented,
 130         [in,size_is(cImplemented)] CATID rgcatidImpl[],
 131         [in] ULONG cRequired,
 132         [in,size_is(cRequired)] CATID rgcatidReq[],
 133         [out] IEnumCLSID** ppenumClsid);
 134
 135     [call_as(EnumClassesOfCategories)]
 136     HRESULT RemoteEnumClassesOfCategories(
 137         [in] ULONG cImplemented,
 138         [in,unique,size_is(cImplemented)] CATID rgcatidImpl[],
 139         [in] ULONG cRequired,
 140         [in,unique,size_is(cRequired)] CATID rgcatidReq[],
 141         [out] IEnumCLSID** ppenumClsid);
 142
 143     [local]
 144     HRESULT IsClassOfCategories(
 145         [in] REFCLSID rclsid,
 146         [in] ULONG cImplemented,
 147         [in,size_is(cImplemented)] CATID rgcatidImpl[],
 148         [in] ULONG cRequired,
 149         [in,size_is(cRequired)] CATID rgcatidReq[]);
 150
 151     [call_as(IsClassOfCategories)]
 152     HRESULT RemoteIsClassOfCategories(
 153         [in] REFCLSID rclsid,
 154         [in] ULONG cImplemented,
 155         [in,unique,size_is(cImplemented)] CATID rgcatidImpl[],
 156         [in] ULONG cRequired,
 157         [in,unique,size_is(cRequired)] CATID rgcatidReq[] );
 158
 159     HRESULT EnumImplCategoriesOfClass(
 160         [in] REFCLSID rclsid,
 161         [out] IEnumCATID** ppenumCatid);
 162
 163     HRESULT EnumReqCategoriesOfClass(
 164         [in] REFCLSID rclsid,
 165         [out] IEnumCATID** ppenumCatid);
 166 }
 167
 168
 169 /*****************************************************************************
 170  * ICatRegister
 171  */
 172 [
 173     object,
 174     uuid(0002e012-0000-0000-c000-000000000046),
 175     pointer_default(unique)
 176 ]
 177 interface ICatRegister : IUnknown
 178 {
 179     typedef [unique] ICatRegister* LPCATREGISTER;
 180
 181     HRESULT RegisterCategories(
 182         [in] ULONG cCategories,
 183         [in, size_is(cCategories)] CATEGORYINFO rgCategoryInfo[]);
 184
 185     HRESULT UnRegisterCategories(
 186         [in] ULONG cCategories,
 187         [in, size_is(cCategories)] CATID rgcatid[]);
 188
 189     HRESULT RegisterClassImplCategories(
 190         [in] REFCLSID rclsid,
 191         [in] ULONG cCategories,
 192         [in, size_is(cCategories)] CATID rgcatid[]);
 193
 194     HRESULT UnRegisterClassImplCategories(
 195         [in] REFCLSID rclsid,
 196         [in] ULONG cCategories,
 197         [in, size_is(cCategories)] CATID rgcatid[]);
 198
 199     HRESULT RegisterClassReqCategories(
 200         [in] REFCLSID rclsid,
 201         [in] ULONG cCategories,
 202         [in, size_is(cCategories)] CATID rgcatid[]);
 203
 204     HRESULT UnRegisterClassReqCategories(
 205         [in] REFCLSID rclsid,
 206         [in] ULONG cCategories,
 207         [in, size_is(cCategories)] CATID rgcatid[]);
 208 }
 209
 210
 211 /*****************************************************************************
 212  * Category IDs
 213  */
 214 cpp_quote("DEFINE_GUID( CATID_Insertable, 0x40fc6ed3, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 215 cpp_quote("DEFINE_GUID( CATID_Control, 0x40fc6ed4, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 216 cpp_quote("DEFINE_GUID( CATID_Programmable, 0x40fc6ed5, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 217 cpp_quote("DEFINE_GUID( CATID_IsShortcut, 0x40fc6ed6, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 218 cpp_quote("DEFINE_GUID( CATID_NeverShowExt, 0x40fc6ed7, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 219 cpp_quote("DEFINE_GUID( CATID_DocObject, 0x40fc6ed8, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 220 cpp_quote("DEFINE_GUID( CATID_Printable, 0x40fc6ed9, 0x2438, 0x11cf, 0xa3, 0xdb, 0x08, 0x00, 0x36, 0xf1, 0x25, 0x02);")
 221 cpp_quote("DEFINE_GUID( CATID_RequiresDataPathHost, 0x0de86a50, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 222 cpp_quote("DEFINE_GUID( CATID_PersistsToMoniker, 0x0de86a51, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 223 cpp_quote("DEFINE_GUID( CATID_PersistsToStorage, 0x0de86a52, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 224 cpp_quote("DEFINE_GUID( CATID_PersistsToStreamInit, 0x0de86a53, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 225 cpp_quote("DEFINE_GUID( CATID_PersistsToStream, 0x0de86a54, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 226 cpp_quote("DEFINE_GUID( CATID_PersistsToMemory, 0x0de86a55, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 227 cpp_quote("DEFINE_GUID( CATID_PersistsToFile, 0x0de86a56, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 228 cpp_quote("DEFINE_GUID( CATID_PersistsToPropertyBag, 0x0de86a57, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 229 cpp_quote("DEFINE_GUID( CATID_InternetAware, 0x0de86a58, 0x2baa, 0x11cf, 0xa2, 0x29, 0x00, 0xaa, 0x00, 0x3d, 0x73, 0x52);")
 230 cpp_quote("DEFINE_GUID( CATID_DesignTimeUIActivatableControl, 0xf2bb56d1, 0xdb07, 0x11d1, 0xaa, 0x6b, 0x00, 0x60, 0x97, 0xdb, 0x95, 0x39);")
 231 /* The Component Category Manager */
 232 cpp_quote("DEFINE_GUID(CLSID_StdComponentCategoriesMgr, 0x0002e005, 0x00, 0x00, 0xc0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);")