Added a couple of Unicode string routines.
[wine] / include / wine / obj_moniker.h
1 /*
2  * Defines the COM interfaces and APIs related to the moniker functionality.
3  */
4 #ifndef __WINE_WINE_OBJ_MONIKER_H
5 #define __WINE_WINE_OBJ_MONIKER_H
6
7 #include "wine/obj_base.h"
8 #include "wine/obj_storage.h"
9 #include "wine/obj_misc.h"
10
11 #ifdef __cplusplus
12 extern "C" {
13 #endif /* defined(__cplusplus) */
14
15 /*****************************************************************************
16  * Predeclare the interfaces
17  */
18 DEFINE_OLEGUID(IID_IBindCtx,0xe,0,0);
19 typedef struct IBindCtx IBindCtx,*LPBINDCTX;
20 typedef LPBINDCTX LPBC;
21
22 DEFINE_OLEGUID(IID_IClassActivator,     0x00000140L, 0, 0);
23 typedef struct IClassActivator IClassActivator,*LPCLASSACTIVATOR;
24
25 DEFINE_OLEGUID(IID_IEnumMoniker,        0x00000102L, 0, 0);
26 typedef struct IEnumMoniker IEnumMoniker,*LPENUMMONIKER;
27
28 DEFINE_OLEGUID(IID_IMoniker,            0x0000000fL, 0, 0);
29 typedef struct IMoniker IMoniker,*LPMONIKER;
30
31 DEFINE_GUID   (IID_IROTData,            0xf29f6bc0L, 0x5021, 0x11ce, 0xaa, 0x15, 0x00, 0x00, 0x69, 0x01, 0x29, 0x3f);
32 typedef struct IROTData IROTData,*LPROTDATA;
33
34 DEFINE_OLEGUID(IID_IRunnableObject,     0x00000126L, 0, 0);
35 typedef struct IRunnableObject IRunnableObject,*LPRUNNABLEOBJECT;
36
37 DEFINE_OLEGUID(IID_IRunningObjectTable, 0x00000010L, 0, 0);
38 typedef struct IRunningObjectTable IRunningObjectTable,*LPRUNNINGOBJECTTABLE;
39
40 DEFINE_GUID( CLSID_FileMoniker,0x00000303,0,0,0xc0,0,0,0,0,0,0,0x46);
41
42 DEFINE_GUID( CLSID_ItemMoniker,0x00000304,0,0,0xc0,0,0,0,0,0,0,0x46);
43
44 DEFINE_GUID( CLSID_AntiMoniker,0x00000305,0,0,0xc0,0,0,0,0,0,0,0x46);
45
46 DEFINE_GUID( CLSID_CompositeMoniker,0x00000309,0,0,0xc0,0,0,0,0,0,0,0x46);
47
48 /*********************************************************************************
49  *      BIND_OPTS and BIND_OPTS2 structures definition
50  *      These structures contain parameters used during a moniker-binding operation.
51  *********************************************************************************/
52 typedef struct tagBIND_OPTS
53 {
54     DWORD cbStruct;
55     DWORD grfFlags;
56     DWORD grfMode;
57     DWORD dwTickCountDeadline;
58 } BIND_OPTS, * LPBIND_OPTS;
59
60 typedef struct tagBIND_OPTS2
61 {
62     DWORD cbStruct;
63     DWORD grfFlags;
64     DWORD grfMode;
65     DWORD dwTickCountDeadline;
66     DWORD dwTrackFlags;
67     DWORD dwClassContext;
68     LCID  locale;
69     COSERVERINFO* pServerInfo;
70 } BIND_OPTS2, * LPBIND_OPTS2;
71
72 /*****************************************************************************
73  * IBindCtx interface
74  */
75 #define ICOM_INTERFACE IBindCtx
76 #define IBindCtx_METHODS \
77     ICOM_METHOD1 (HRESULT, RegisterObjectBound,  IUnknown*,punk) \
78     ICOM_METHOD1 (HRESULT, RevokeObjectBound,    IUnknown*,punk) \
79     ICOM_METHOD  (HRESULT, ReleaseBoundObjects) \
80     ICOM_METHOD1 (HRESULT, SetBindOptions,       LPBIND_OPTS2,pbindopts) \
81     ICOM_METHOD1 (HRESULT, GetBindOptions,       LPBIND_OPTS2,pbindopts) \
82     ICOM_METHOD1 (HRESULT, GetRunningObjectTable,IRunningObjectTable**,pprot) \
83     ICOM_METHOD2 (HRESULT, RegisterObjectParam,  LPOLESTR,pszkey, IUnknown*,punk) \
84     ICOM_METHOD2 (HRESULT, GetObjectParam,       LPOLESTR,pszkey, IUnknown**,punk) \
85     ICOM_METHOD1 (HRESULT, EnumObjectParam,      IEnumString**,ppenum) \
86     ICOM_METHOD1 (HRESULT, RevokeObjectParam,    LPOLESTR,pszkey)
87 #define IBindCtx_IMETHODS \
88     IUnknown_IMETHODS \
89     IBindCtx_METHODS
90 ICOM_DEFINE(IBindCtx,IUnknown)
91 #undef ICOM_INTERFACE
92
93 /*** IUnknown methods ***/
94 #define IBindCtx_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
95 #define IBindCtxr_AddRef(p)            ICOM_CALL (AddRef,p)
96 #define IBindCtx_Release(p)            ICOM_CALL (Release,p)
97 /* IBindCtx methods*/
98 #define IBindCtx_RegisterObjectBound(p,a)   ICOM_CALL1(RegisterObjectBound,p,a)
99 #define IBindCtx_RevokeObjectBound(p,a)     ICOM_CALL1(RevokeObjectBound,p,a)
100 #define IBindCtx_ReleaseBoundObjects(p)     ICOM_CALL (ReleaseBoundObjects,p)
101 #define IBindCtx_SetBindOptions(p,a)        ICOM_CALL1(SetBindOptions,p,a)
102 #define IBindCtx_GetBindOptions(p,a)        ICOM_CALL1(GetBindOptions,p,a)
103 #define IBindCtx_GetRunningObjectTable(p,a) ICOM_CALL1(GetRunningObjectTable,p,a)
104 #define IBindCtx_RegisterObjectParam(p,a,b) ICOM_CALL2(RegisterObjectParam,p,a,b)
105 #define IBindCtx_GetObjectParam(p,a,b)      ICOM_CALL2(GetObjectParam,p,a,b)
106 #define IBindCtx_EnumObjectParam(p,a)       ICOM_CALL1(EnumObjectParam,p,a)
107 #define IBindCtx_RevokeObjectParam(p,a)     ICOM_CALL1(RevokeObjectParam,p,a)
108
109 HRESULT WINAPI CreateBindCtx16(DWORD reserved, LPBC* ppbc);
110 HRESULT WINAPI CreateBindCtx(DWORD reserved, LPBC* ppbc);
111
112 /*****************************************************************************
113  * IClassActivator interface
114  */
115 #define ICOM_INTERFACE IClassActivator
116 #define IClassActivator_METHODS \
117     ICOM_METHOD5(HRESULT,GetClassObject, REFCLSID,rclsid, DWORD,dwClassContext, LCID,locale, REFIID,riid, void**,ppv)
118 #define IClassActivator_IMETHODS \
119     IUnknown_IMETHODS \
120     IClassActivator_METHODS
121 ICOM_DEFINE(IClassActivator,IUnknown)
122 #undef ICOM_INTERFACE
123
124 /*** IUnknown methods ***/
125 #define IClassActivator_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
126 #define IClassActivator_AddRef(p)             ICOM_CALL (AddRef,p)
127 #define IClassActivator_Release(p)            ICOM_CALL (Release,p)
128 /*** IClassActivator methods ***/
129 #define IClassActivator_GetClassObject(p,a,b,c,d,e) ICOM_CALL5(GetClassObject,p,a,b,c,d,e)
130
131
132 /*****************************************************************************
133  * IEnumMoniker interface
134  */
135 #define ICOM_INTERFACE IEnumMoniker
136 #define IEnumMoniker_METHODS \
137     ICOM_METHOD3(HRESULT,Next,  ULONG,celt, IMoniker**,rgelt, ULONG*,pceltFethed) \
138     ICOM_METHOD1(HRESULT,Skip,  ULONG,celt) \
139     ICOM_METHOD (HRESULT,Reset) \
140     ICOM_METHOD1(HRESULT,Clone, IEnumMoniker**,ppenum)
141 #define IEnumMoniker_IMETHODS \
142     IUnknown_IMETHODS \
143     IEnumMoniker_METHODS
144 ICOM_DEFINE(IEnumMoniker,IUnknown)
145 #undef ICOM_INTERFACE
146
147 /*** IUnknown methods ***/
148 #define IEnumMoniker_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
149 #define IEnumMoniker_AddRef(p)             ICOM_CALL (AddRef,p)
150 #define IEnumMoniker_Release(p)            ICOM_CALL (Release,p)
151 /*** IEnumMoniker methods ***/
152 #define IEnumMoniker_Next(p,a,b,c) ICOM_CALL3(Next,p,a,b,c)
153 #define IEnumMoniker_Skip(p,a)     ICOM_CALL1(Skip,p,a)
154 #define IEnumMoniker_Reset(p)      ICOM_CALL (Reset,p)
155 #define IEnumMoniker_Clone(p,a)    ICOM_CALL1(Clone,p,a)
156
157 /*****************************************************************************
158  * IMoniker interface
159  */
160
161 typedef enum tagMKSYS
162 {
163     MKSYS_NONE              = 0,
164     MKSYS_GENERICCOMPOSITE  = 1,
165     MKSYS_FILEMONIKER       = 2,
166     MKSYS_ANTIMONIKER       = 3,
167     MKSYS_ITEMMONIKER       = 4,
168     MKSYS_POINTERMONIKER    = 5,
169     MKSYS_CLASSMONIKER      = 7
170 } MKSYS;
171
172 typedef enum tagMKREDUCE
173 {
174     MKRREDUCE_ONE           = 3 << 16,
175     MKRREDUCE_TOUSER        = 2 << 16,
176     MKRREDUCE_THROUGHUSER   = 1 << 16,
177     MKRREDUCE_ALL           = 0
178 } MKRREDUCE;
179
180 #define ICOM_INTERFACE IMoniker
181 #define IMoniker_METHODS \
182     ICOM_METHOD4(HRESULT,BindToObject,        IBindCtx*,pbc, IMoniker*,pmkToLeft, REFIID,riidResult, void**,ppvResult) \
183     ICOM_METHOD4(HRESULT,BindToStorage,       IBindCtx*,pbc, IMoniker*,pmkToLeft, REFIID,riid, void**,ppvObj) \
184     ICOM_METHOD4(HRESULT,Reduce,              IBindCtx*,pbc, DWORD,dwReduceHowFar, IMoniker**,ppmkToLeft, IMoniker**,ppmkReduced) \
185     ICOM_METHOD3(HRESULT,ComposeWith,         IMoniker*,pmkRight, BOOL,fOnlyIfNotGeneric, IMoniker**,ppmkComposite) \
186     ICOM_METHOD2(HRESULT,Enum,                BOOL,fForward, IEnumMoniker**,ppenumMoniker) \
187     ICOM_METHOD1(HRESULT,IsEqual,             IMoniker*,pmkOtherMoniker) \
188     ICOM_METHOD1(HRESULT,Hash,                DWORD*,pdwHash) \
189     ICOM_METHOD3(HRESULT,IsRunning,           IBindCtx*,pbc, IMoniker*,pmkToLeft, IMoniker*,pmkNewlyRunning) \
190     ICOM_METHOD3(HRESULT,GetTimeOfLastChange, IBindCtx*,pbc, IMoniker*,pmkToLeft, FILETIME*,pFileTime) \
191     ICOM_METHOD1(HRESULT,Inverse,             IMoniker**,ppmk) \
192     ICOM_METHOD2(HRESULT,CommonPrefixWith,    IMoniker*,pmkOtherMoniker, IMoniker**,ppmkPrefix) \
193     ICOM_METHOD2(HRESULT,RelativePathTo,      IMoniker*,pmkOther, IMoniker**,ppmkRelPath) \
194     ICOM_METHOD3(HRESULT,GetDisplayName,      IBindCtx*,pbc, IMoniker*,pmkToLeft, LPOLESTR*,ppszDisplayName) \
195     ICOM_METHOD5(HRESULT,ParseDisplayName,    IBindCtx*,pbc, IMoniker*,pmkToLeft, LPOLESTR,pszDisplayName, ULONG*,pchEaten, IMoniker**,ppmkOut) \
196     ICOM_METHOD1(HRESULT,IsSystemMoniker,     DWORD*,pdwMksys)
197 #define IMoniker_IMETHODS \
198     IPersistStream_IMETHODS \
199     IMoniker_METHODS
200 ICOM_DEFINE(IMoniker,IPersistStream)
201 #undef ICOM_INTERFACE
202
203 /*** IUnknown methods ***/
204 #define IMoniker_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
205 #define IMoniker_AddRef(p)             ICOM_CALL (AddRef,p)
206 #define IMoniker_Release(p)            ICOM_CALL (Release,p)
207
208 /*** IPersist methods ***/
209 #define IMoniker_GetClassID(p,a) ICOM_CALL1(GetClassID,p,a)
210 /*** IPersistStream methods ***/
211 #define IMoniker_IsDirty(p)      ICOM_CALL (IsDirty,p)
212 #define IMoniker_Load(p,a)       ICOM_CALL1(Load,p,a)
213 #define IMoniker_Save(p,a,b)     ICOM_CALL2(Save,p,a,b)
214 #define IMoniker_GetSizeMax(p,a) ICOM_CALL1(GetSizeMax,p,a)
215 /*** IMoniker methods ***/
216 #define IMoniker_BindToObject(p,a,b,c,d)            ICOM_CALL4(BindToObject,p,a,b,c,d)
217 #define IMoniker_BindToStorage(p,a,b,c,d)           ICOM_CALL4(BindToStorage,p,a,b,c,d)
218 #define IMoniker_Reduce(p,a,b,c,d)                  ICOM_CALL4(Reduce,p,a,b,c,d)
219 #define IMoniker_ComposeWith(p,a,b,c)               ICOM_CALL3(ComposeWith,p,a,b,c)
220 #define IMoniker_Enum(p,a,b)                        ICOM_CALL2(Enum,p,a,b)
221 #define IMoniker_IsEqual(p,a)                       ICOM_CALL1(IsEqual,p,a)
222 #define IMoniker_Hash(p,a)                          ICOM_CALL1(Hash,p,a)
223 #define IMoniker_IsRunning(p,a,b,c)                 ICOM_CALL3(IsRunning,p,a,b,c)
224 #define IMoniker_GetTimeOfLastChange(p,a,b,c)       ICOM_CALL3(GetTimeOfLastChange,p,a,b,c)
225 #define IMoniker_Inverse(p,a)                       ICOM_CALL1(Inverse,p,a)
226 #define IMoniker_CommonPrefixWith(p,a,b)            ICOM_CALL2(CommonPrefixWith,p,a,b)
227 #define IMoniker_RelativePathTo(p,a,b)              ICOM_CALL2(RelativePathTo,p,a,b)
228 #define IMoniker_GetDisplayName(p,a,b,c)            ICOM_CALL3(GetDisplayName,p,a,b,c)
229 #define IMoniker_ParseDisplayName(p,a,b,c,d,e)      ICOM_CALL5(ParseDisplayName,p,a,b,c,d,e)
230 #define IMoniker_IsSystemMoniker(p,a)               ICOM_CALL1(IsSystemMoniker,p,a)
231
232 HRESULT WINAPI CreateFileMoniker16(LPCOLESTR16 lpszPathName, LPMONIKER* ppmk);
233 HRESULT WINAPI CreateFileMoniker(LPCOLESTR lpszPathName, LPMONIKER* ppmk);
234
235 HRESULT WINAPI CreateItemMoniker16(LPCOLESTR16 lpszDelim, LPCOLESTR  lpszItem, LPMONIKER* ppmk);
236 HRESULT WINAPI CreateItemMoniker(LPCOLESTR lpszDelim, LPCOLESTR  lpszItem, LPMONIKER* ppmk);
237
238 HRESULT WINAPI CreateAntiMoniker(LPMONIKER * ppmk);
239
240 HRESULT WINAPI CreateGenericComposite(LPMONIKER pmkFirst, LPMONIKER pmkRest, LPMONIKER* ppmkComposite);
241
242 /* FIXME: not implemented */
243 HRESULT WINAPI  BindMoniker(LPMONIKER pmk, DWORD grfOpt, REFIID iidResult, LPVOID* ppvResult);
244
245 /* FIXME: not implemented */
246 HRESULT WINAPI CreateClassMoniker(REFCLSID rclsid, LPMONIKER* ppmk);
247
248 /* FIXME: not implemented */
249 HRESULT WINAPI CreatePointerMoniker(LPUNKNOWN punk, LPMONIKER* ppmk);
250
251 /* FIXME: not implemented */
252 HRESULT WINAPI MonikerCommonPrefixWith(IMoniker* pmkThis,IMoniker* pmkOther,IMoniker** ppmkCommon);
253 /*****************************************************************************
254  * IROTData interface
255  */
256 #define ICOM_INTERFACE IROTData
257 #define IROTData_METHODS \
258     ICOM_METHOD3(HRESULT,GetComparisonData, byte*,pbData, ULONG,cbMax, ULONG*,pcbData)
259 #define IROTData_IMETHODS \
260     IUnknown_IMETHODS \
261     IROTData_METHODS
262 ICOM_DEFINE(IROTData,IUnknown)
263 #undef ICOM_INTERFACE
264
265 /*** IUnknown methods ***/
266 #define IROTData_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
267 #define IROTData_AddRef(p)             ICOM_CALL (AddRef,p)
268 #define IROTData_Release(p)            ICOM_CALL (Release,p)
269 /*** IROTData methods ***/
270 #define IROTData_GetComparisonData(p,a,b,c) ICOM_CALL3(GetComparisonData,p,a,b,c)
271
272 #define ICOM_THIS_From_IROTData(class, name) class* This = (class*)(((char*)name)-sizeof(void*))
273
274 /*****************************************************************************
275  * IRunnableObject interface
276  */
277 #define ICOM_INTERFACE IRunnableObject
278 #define IRunnableObject_METHODS \
279     ICOM_METHOD1(HRESULT,GetRunningClass,    LPCLSID,lpClsid) \
280     ICOM_METHOD1(HRESULT,Run,                IBindCtx*,pbc) \
281     ICOM_METHOD (BOOL,IsRunning) \
282     ICOM_METHOD2(HRESULT,LockRunning,        BOOL,fLock, BOOL,fLastUnlockCloses) \
283     ICOM_METHOD1(HRESULT,SetContainedObject, BOOL,fContained)
284 #define IRunnableObject_IMETHODS \
285     IUnknown_IMETHODS \
286     IRunnableObject_METHODS
287 ICOM_DEFINE(IRunnableObject,IUnknown)
288 #undef ICOM_INTERFACE
289
290 /*** IUnknown methods ***/
291 #define IRunnableObject_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
292 #define IRunnableObject_AddRef(p)             ICOM_CALL (AddRef,p)
293 #define IRunnableObject_Release(p)            ICOM_CALL (Release,p)
294 /*** IRunnableObject methods ***/
295 #define IRunnableObject_GetRunningClass(p,a)    ICOM_CALL1(GetRunningClass,p,a)
296 #define IRunnableObject_Run(p,a)                ICOM_CALL1(Run,p,a)
297 #define IRunnableObject_IsRunning(p)            ICOM_CALL (IsRunning,p)
298 #define IRunnableObject_LockRunning(p,a,b)      ICOM_CALL2(LockRunning,p,a,b)
299 #define IRunnableObject_SetContainedObject(p,a) ICOM_CALL1(SetContainedObject,p,a)
300
301
302 /*****************************************************************************
303  * IRunningObjectTable interface
304  */
305 #define ICOM_INTERFACE IRunningObjectTable
306 #define IRunningObjectTable_METHODS \
307     ICOM_METHOD4(HRESULT,Register,            DWORD,grfFlags, IUnknown*,punkObject, IMoniker*,pmkObjectName, DWORD*,pdwRegister) \
308     ICOM_METHOD1(HRESULT,Revoke,              DWORD,dwRegister) \
309     ICOM_METHOD1(HRESULT,IsRunning,           IMoniker*,pmkObjectName) \
310     ICOM_METHOD2(HRESULT,GetObject,           IMoniker*,pmkObjectName, IUnknown**,ppunkObject) \
311     ICOM_METHOD2(HRESULT,NoteChangeTime,      DWORD,dwRegister, FILETIME*,pfiletime) \
312     ICOM_METHOD2(HRESULT,GetTimeOfLastChange, IMoniker*,pmkObjectName, FILETIME*,pfiletime) \
313     ICOM_METHOD1(HRESULT,EnumRunning,         IEnumMoniker**,ppenumMoniker)
314 #define IRunningObjectTable_IMETHODS \
315     IUnknown_IMETHODS \
316     IRunningObjectTable_METHODS
317 ICOM_DEFINE(IRunningObjectTable,IUnknown)
318 #undef ICOM_INTERFACE
319
320 /*** IUnknown methods ***/
321 #define IRunningObjectTable_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
322 #define IRunningObjectTable_AddRef(p)             ICOM_CALL (AddRef,p)
323 #define IRunningObjectTable_Release(p)            ICOM_CALL (Release,p)
324 /*** IRunningObjectTable methods ***/
325 #define IRunningObjectTable_Register(p,a,b,c,d)        ICOM_CALL4(Register,p,a,b,c,d)
326 #define IRunningObjectTable_Revoke(p,a)                ICOM_CALL1(Revoke,p,a)
327 #define IRunningObjectTable_IsRunning(p,a)             ICOM_CALL1(IsRunning,p,a)
328 #define IRunningObjectTable_GetObject(p,a,b)           ICOM_CALL2(GetObject,p,a,b)
329 #define IRunningObjectTable_NoteChangeTime(p,a,b)      ICOM_CALL2(NoteChangeTime,p,a,b)
330 #define IRunningObjectTable_GetTimeOfLastChange(p,a,b) ICOM_CALL2(GetTimeOfLastChange,p,a,b)
331 #define IRunningObjectTable_EnumRunning(p,a)           ICOM_CALL1(EnumRunning,p,a)
332
333 HRESULT WINAPI GetRunningObjectTable(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot);
334 HRESULT WINAPI GetRunningObjectTable16(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot);
335
336 /*****************************************************************************
337  * Additional API
338  */
339
340 /* FIXME: not implemented */
341 HRESULT WINAPI CoGetInstanceFromFile(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, DWORD grfMode, OLECHAR* pwszName, DWORD dwCount, MULTI_QI* pResults);
342
343 /* FIXME: not implemented */
344 HRESULT WINAPI CoGetInstanceFromIStorage(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, IStorage* pstg, DWORD dwCount, MULTI_QI* pResults);
345
346 #ifdef __cplusplus
347 } /* extern "C" */
348 #endif /* defined(__cplusplus) */
349
350 #endif /* __WINE_WINE_OBJ_MONIKER_H */