include: Add IProvideRuntimeContext and a few annotations.
[wine/hramrach.git] / include / comcat.idl
blob010db7d3c8cf3e865e9da38788ca67e1280ae12a
1 /*
2 * Copyright 2002 John K. Hohm
3 * Copyright 2003 Alexandre Julliard
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.
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.
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
20 #ifndef DO_NO_IMPORTS
21 import "unknwn.idl";
22 #endif
24 /*****************************************************************************
25 * Types
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)")
32 /*****************************************************************************
33 * Aliases for EnumGUID
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")
45 /*****************************************************************************
46 * IEnumGUID
49 object,
50 uuid(0002e000-0000-0000-c000-000000000046),
51 pointer_default(unique)
53 interface IEnumGUID : IUnknown
55 typedef [unique] IEnumGUID *LPENUMGUID;
57 HRESULT Next(
58 [in] ULONG celt,
59 [out, size_is(celt), length_is(*pceltFetched)] GUID *rgelt,
60 [out] ULONG *pceltFetched);
62 HRESULT Skip(
63 [in] ULONG celt);
65 HRESULT Reset();
67 HRESULT Clone(
68 [out] IEnumGUID **ppenum);
72 /*****************************************************************************
73 * IEnumCATEGORYINFO
76 object,
77 uuid(0002e011-0000-0000-c000-000000000046),
78 pointer_default(unique)
80 interface IEnumCATEGORYINFO : IUnknown
82 typedef [unique] IEnumCATEGORYINFO *LPENUMCATEGORYINFO;
84 typedef struct tagCATEGORYINFO
86 CATID catid; /* category identifier for component */
87 LCID lcid; /* locale identifier */
88 OLECHAR szDescription[128]; /* description of the category */
89 } CATEGORYINFO, *LPCATEGORYINFO;
91 HRESULT Next(
92 [in] ULONG celt,
93 [out, size_is(celt), length_is(*pceltFetched)] CATEGORYINFO* rgelt,
94 [out] ULONG* pceltFetched);
96 HRESULT Skip(
97 [in] ULONG celt);
99 HRESULT Reset();
101 HRESULT Clone(
102 [out] IEnumCATEGORYINFO** ppenum);
106 /*****************************************************************************
107 * ICatInformation
110 object,
111 uuid(0002e013-0000-0000-c000-000000000046),
112 pointer_default(unique)
114 interface ICatInformation : IUnknown
116 typedef [unique] ICatInformation* LPCATINFORMATION;
118 HRESULT EnumCategories(
119 [in] LCID lcid,
120 [out] IEnumCATEGORYINFO** ppenumCategoryInfo);
122 HRESULT GetCategoryDesc(
123 [in] REFCATID rcatid,
124 [in] LCID lcid,
125 [out] LPWSTR* pszDesc);
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);
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);
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[]);
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[] );
159 HRESULT EnumImplCategoriesOfClass(
160 [in] REFCLSID rclsid,
161 [out] IEnumCATID** ppenumCatid);
163 HRESULT EnumReqCategoriesOfClass(
164 [in] REFCLSID rclsid,
165 [out] IEnumCATID** ppenumCatid);
169 /*****************************************************************************
170 * ICatRegister
173 object,
174 uuid(0002e012-0000-0000-c000-000000000046),
175 pointer_default(unique)
177 interface ICatRegister : IUnknown
179 typedef [unique] ICatRegister* LPCATREGISTER;
181 HRESULT RegisterCategories(
182 [in] ULONG cCategories,
183 [in, size_is(cCategories)] CATEGORYINFO rgCategoryInfo[]);
185 HRESULT UnRegisterCategories(
186 [in] ULONG cCategories,
187 [in, size_is(cCategories)] CATID rgcatid[]);
189 HRESULT RegisterClassImplCategories(
190 [in] REFCLSID rclsid,
191 [in] ULONG cCategories,
192 [in, size_is(cCategories)] CATID rgcatid[]);
194 HRESULT UnRegisterClassImplCategories(
195 [in] REFCLSID rclsid,
196 [in] ULONG cCategories,
197 [in, size_is(cCategories)] CATID rgcatid[]);
199 HRESULT RegisterClassReqCategories(
200 [in] REFCLSID rclsid,
201 [in] ULONG cCategories,
202 [in, size_is(cCategories)] CATID rgcatid[]);
204 HRESULT UnRegisterClassReqCategories(
205 [in] REFCLSID rclsid,
206 [in] ULONG cCategories,
207 [in, size_is(cCategories)] CATID rgcatid[]);
211 /*****************************************************************************
212 * Category IDs
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);")