winuser.h: Define browser and multimedia keys.
[wine] / 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);")