comdlg32: CDM_GETSPEC and CDM_GETFILEPATH should preserve double quotes in file lists.
[wine] / include / objbase.h
1 /*
2  * Copyright (C) 1998-1999 Francois Gouget
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
17  */
18
19 #include <rpc.h>
20 #include <rpcndr.h>
21
22 #ifndef _OBJBASE_H_
23 #define _OBJBASE_H_
24
25 /*****************************************************************************
26  * Macros to define a COM interface
27  */
28 /*
29  * The goal of the following set of definitions is to provide a way to use the same
30  * header file definitions to provide both a C interface and a C++ object oriented
31  * interface to COM interfaces. The type of interface is selected automatically
32  * depending on the language but it is always possible to get the C interface in C++
33  * by defining CINTERFACE.
34  *
35  * It is based on the following assumptions:
36  *  - all COM interfaces derive from IUnknown, this should not be a problem.
37  *  - the header file only defines the interface, the actual fields are defined
38  *    separately in the C file implementing the interface.
39  *
40  * The natural approach to this problem would be to make sure we get a C++ class and
41  * virtual methods in C++ and a structure with a table of pointer to functions in C.
42  * Unfortunately the layout of the virtual table is compiler specific, the layout of
43  * g++ virtual tables is not the same as that of an egcs virtual table which is not the
44  * same as that generated by Visual C+. There are workarounds to make the virtual tables
45  * compatible via padding but unfortunately the one which is imposed to the WINE emulator
46  * by the Windows binaries, i.e. the Visual C++ one, is the most compact of all.
47  *
48  * So the solution I finally adopted does not use virtual tables. Instead I use inline
49  * non virtual methods that dereference the method pointer themselves and perform the call.
50  *
51  * Let's take Direct3D as an example:
52  *
53  *    #define INTERFACE IDirect3D
54  *    DECLARE_INTERFACE_(IDirect3D,IUnknown)
55  *    {
56  *        // *** IUnknown methods *** //
57  *        STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID, void**) PURE;
58  *        STDMETHOD_(ULONG,AddRef)(THIS) PURE;
59  *        STDMETHOD_(ULONG,Release)(THIS) PURE;
60  *        // *** IDirect3D methods *** //
61  *        STDMETHOD(Initialize)(THIS_ REFIID) PURE;
62  *        STDMETHOD(EnumDevices)(THIS_ LPD3DENUMDEVICESCALLBACK, LPVOID) PURE;
63  *        STDMETHOD(CreateLight)(THIS_ LPDIRECT3DLIGHT *, IUnknown *) PURE;
64  *        STDMETHOD(CreateMaterial)(THIS_ LPDIRECT3DMATERIAL *, IUnknown *) PURE;
65  *        STDMETHOD(CreateViewport)(THIS_ LPDIRECT3DVIEWPORT *, IUnknown *) PURE;
66  *        STDMETHOD(FindDevice)(THIS_ LPD3DFINDDEVICESEARCH, LPD3DFINDDEVICERESULT) PURE;
67  *    };
68  *    #undef INTERFACE
69  *
70  *    #ifdef COBJMACROS
71  *    // *** IUnknown methods *** //
72  *    #define IDirect3D_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
73  *    #define IDirect3D_AddRef(p)             (p)->lpVtbl->AddRef(p)
74  *    #define IDirect3D_Release(p)            (p)->lpVtbl->Release(p)
75  *    // *** IDirect3D methods *** //
76  *    #define IDirect3D_Initialize(p,a)       (p)->lpVtbl->Initialize(p,a)
77  *    #define IDirect3D_EnumDevices(p,a,b)    (p)->lpVtbl->EnumDevice(p,a,b)
78  *    #define IDirect3D_CreateLight(p,a,b)    (p)->lpVtbl->CreateLight(p,a,b)
79  *    #define IDirect3D_CreateMaterial(p,a,b) (p)->lpVtbl->CreateMaterial(p,a,b)
80  *    #define IDirect3D_CreateViewport(p,a,b) (p)->lpVtbl->CreateViewport(p,a,b)
81  *    #define IDirect3D_FindDevice(p,a,b)     (p)->lpVtbl->FindDevice(p,a,b)
82  *    #endif
83  *
84  * Comments:
85  *  - The INTERFACE macro is used in the STDMETHOD macros to define the type of the 'this'
86  *    pointer. Defining this macro here saves us the trouble of having to repeat the interface
87  *    name everywhere. Note however that because of the way macros work, a macro like STDMETHOD
88  *    cannot use 'INTERFACE##_VTABLE' because this would give 'INTERFACE_VTABLE' and not
89  *    'IDirect3D_VTABLE'.
90  *  - The DECLARE_INTERFACE declares all the structures necessary for the interface. We have to
91  *    explicitly use the interface name for macro expansion reasons again. It defines the list of
92  *    methods that are inheritable from this interface. It must be written manually (rather than
93  *    using a macro to generate the equivalent code) to avoid macro recursion (which compilers
94  *    don't like). It must start with the methods definition of the parent interface so that
95  *    method inheritance works properly.
96  *  - The 'undef INTERFACE' is here to remind you that using INTERFACE in the following macros
97  *    will not work.
98  *  - Finally the set of 'IDirect3D_Xxx' macros is a standard set of macros defined to ease access
99  *    to the interface methods in C. Unfortunately I don't see any way to avoid having to duplicate
100  *    the inherited method definitions there. This time I could have used a trick to use only one
101  *    macro whatever the number of parameters but I preferred to have it work the same way as above.
102  *  - You probably have noticed that we don't define the fields we need to actually implement this
103  *    interface: reference count, pointer to other resources and miscellaneous fields. That's
104  *    because these interfaces are just that: interfaces. They may be implemented more than once, in
105  *    different contexts and sometimes not even in Wine. Thus it would not make sense to impose
106  *    that the interface contains some specific fields.
107  *
108  *
109  * In C this gives:
110  *    typedef struct IDirect3DVtbl IDirect3DVtbl;
111  *    struct IDirect3D {
112  *        IDirect3DVtbl* lpVtbl;
113  *    };
114  *    struct IDirect3DVtbl {
115  *        HRESULT (*QueryInterface)(IDirect3D* me, REFIID riid, LPVOID* ppvObj);
116  *        ULONG (*AddRef)(IDirect3D* me);
117  *        ULONG (*Release)(IDirect3D* me);
118  *        HRESULT (*Initialize)(IDirect3D* me, REFIID a);
119  *        HRESULT (*EnumDevices)(IDirect3D* me, LPD3DENUMDEVICESCALLBACK a, LPVOID b);
120  *        HRESULT (*CreateLight)(IDirect3D* me, LPDIRECT3DLIGHT* a, IUnknown* b);
121  *        HRESULT (*CreateMaterial)(IDirect3D* me, LPDIRECT3DMATERIAL* a, IUnknown* b);
122  *        HRESULT (*CreateViewport)(IDirect3D* me, LPDIRECT3DVIEWPORT* a, IUnknown* b);
123  *        HRESULT (*FindDevice)(IDirect3D* me, LPD3DFINDDEVICESEARCH a, LPD3DFINDDEVICERESULT b);
124  *    };
125  *
126  *    #ifdef COBJMACROS
127  *    // *** IUnknown methods *** //
128  *    #define IDirect3D_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
129  *    #define IDirect3D_AddRef(p)             (p)->lpVtbl->AddRef(p)
130  *    #define IDirect3D_Release(p)            (p)->lpVtbl->Release(p)
131  *    // *** IDirect3D methods *** //
132  *    #define IDirect3D_Initialize(p,a)       (p)->lpVtbl->Initialize(p,a)
133  *    #define IDirect3D_EnumDevices(p,a,b)    (p)->lpVtbl->EnumDevice(p,a,b)
134  *    #define IDirect3D_CreateLight(p,a,b)    (p)->lpVtbl->CreateLight(p,a,b)
135  *    #define IDirect3D_CreateMaterial(p,a,b) (p)->lpVtbl->CreateMaterial(p,a,b)
136  *    #define IDirect3D_CreateViewport(p,a,b) (p)->lpVtbl->CreateViewport(p,a,b)
137  *    #define IDirect3D_FindDevice(p,a,b)     (p)->lpVtbl->FindDevice(p,a,b)
138  *    #endif
139  *
140  * Comments:
141  *  - IDirect3D only contains a pointer to the IDirect3D virtual/jump table. This is the only thing
142  *    the user needs to know to use the interface. Of course the structure we will define to
143  *    implement this interface will have more fields but the first one will match this pointer.
144  *  - The code generated by DECLARE_INTERFACE defines both the structure representing the interface and
145  *    the structure for the jump table.
146  *  - Each method is declared as a pointer to function field in the jump table. The implementation
147  *    will fill this jump table with appropriate values, probably using a static variable, and
148  *    initialize the lpVtbl field to point to this variable.
149  *  - The IDirect3D_Xxx macros then just derefence the lpVtbl pointer and use the function pointer
150  *    corresponding to the macro name. This emulates the behavior of a virtual table and should be
151  *    just as fast.
152  *  - This C code should be quite compatible with the Windows headers both for code that uses COM
153  *    interfaces and for code implementing a COM interface.
154  *
155  *
156  * And in C++ (with gcc's g++):
157  *
158  *    typedef struct IDirect3D: public IUnknown {
159  *        virtual HRESULT Initialize(REFIID a) = 0;
160  *        virtual HRESULT EnumDevices(LPD3DENUMDEVICESCALLBACK a, LPVOID b) = 0;
161  *        virtual HRESULT CreateLight(LPDIRECT3DLIGHT* a, IUnknown* b) = 0;
162  *        virtual HRESULT CreateMaterial(LPDIRECT3DMATERIAL* a, IUnknown* b) = 0;
163  *        virtual HRESULT CreateViewport(LPDIRECT3DVIEWPORT* a, IUnknown* b) = 0;
164  *        virtual HRESULT FindDevice(LPD3DFINDDEVICESEARCH a, LPD3DFINDDEVICERESULT b) = 0;
165  *    };
166  *
167  * Comments:
168  *  - Of course in C++ we use inheritance so that we don't have to duplicate the method definitions.
169  *  - Finally there is no IDirect3D_Xxx macro. These are not needed in C++ unless the CINTERFACE
170  *    macro is defined in which case we would not be here.
171  *
172  *
173  * Implementing a COM interface.
174  *
175  * This continues the above example. This example assumes that the implementation is in C.
176  *
177  *    typedef struct IDirect3DImpl {
178  *        void* lpVtbl;
179  *        // ...
180  *
181  *    } IDirect3DImpl;
182  *
183  *    static IDirect3DVtbl d3dvt;
184  *
185  *    // implement the IDirect3D methods here
186  *
187  *    int IDirect3D_QueryInterface(IDirect3D* me)
188  *    {
189  *        IDirect3DImpl *This = (IDirect3DImpl *)me;
190  *        // ...
191  *    }
192  *
193  *    // ...
194  *
195  *    static IDirect3DVtbl d3dvt = {
196  *        IDirect3D_QueryInterface,
197  *        IDirect3D_Add,
198  *        IDirect3D_Add2,
199  *        IDirect3D_Initialize,
200  *        IDirect3D_SetWidth
201  *    };
202  *
203  * Comments:
204  *  - We first define what the interface really contains. This is the IDirect3DImpl structure. The
205  *    first field must of course be the virtual table pointer. Everything else is free.
206  *  - Then we predeclare our static virtual table variable, we will need its address in some
207  *    methods to initialize the virtual table pointer of the returned interface objects.
208  *  - Then we implement the interface methods. To match what has been declared in the header file
209  *    they must take a pointer to an IDirect3D structure and we must cast it to an IDirect3DImpl so
210  *    that we can manipulate the fields.
211  *  - Finally we initialize the virtual table.
212  */
213
214 #if defined(__cplusplus) && !defined(CINTERFACE)
215
216 /* C++ interface */
217
218 #define STDMETHOD(method)        virtual HRESULT STDMETHODCALLTYPE method
219 #define STDMETHOD_(type,method)  virtual type STDMETHODCALLTYPE method
220 #define STDMETHODV(method)       virtual HRESULT STDMETHODVCALLTYPE method
221 #define STDMETHODV_(type,method) virtual type STDMETHODVCALLTYPE method
222
223 #define PURE   = 0
224 #define THIS_
225 #define THIS   void
226
227 #define interface struct
228 #define DECLARE_INTERFACE(iface)        interface iface
229 #define DECLARE_INTERFACE_(iface,ibase) interface iface : public ibase
230
231 #define BEGIN_INTERFACE
232 #define END_INTERFACE
233
234 #else  /* __cplusplus && !CINTERFACE */
235
236 /* C interface */
237
238 #define STDMETHOD(method)        HRESULT (STDMETHODCALLTYPE *method)
239 #define STDMETHOD_(type,method)  type (STDMETHODCALLTYPE *method)
240 #define STDMETHODV(method)       HRESULT (STDMETHODVCALLTYPE *method)
241 #define STDMETHODV_(type,method) type (STDMETHODVCALLTYPE *method)
242
243 #define PURE
244 #define THIS_ INTERFACE *This,
245 #define THIS  INTERFACE *This
246
247 #define interface struct
248
249 #ifdef __WINESRC__
250 #define CONST_VTABLE
251 #endif
252
253 #ifdef CONST_VTABLE
254 #undef CONST_VTBL
255 #define CONST_VTBL const
256 #define DECLARE_INTERFACE(iface) \
257          typedef interface iface { const struct iface##Vtbl *lpVtbl; } iface; \
258          typedef struct iface##Vtbl iface##Vtbl; \
259          struct iface##Vtbl
260 #else
261 #undef CONST_VTBL
262 #define CONST_VTBL
263 #define DECLARE_INTERFACE(iface) \
264          typedef interface iface { struct iface##Vtbl *lpVtbl; } iface; \
265          typedef struct iface##Vtbl iface##Vtbl; \
266          struct iface##Vtbl
267 #endif
268 #define DECLARE_INTERFACE_(iface,ibase) DECLARE_INTERFACE(iface)
269
270 #define BEGIN_INTERFACE
271 #define END_INTERFACE
272
273 #endif  /* __cplusplus && !CINTERFACE */
274
275 #ifndef __IRpcStubBuffer_FWD_DEFINED__
276 #define __IRpcStubBuffer_FWD_DEFINED__
277 typedef interface IRpcStubBuffer IRpcStubBuffer;
278 #endif
279 #ifndef __IRpcChannelBuffer_FWD_DEFINED__
280 #define __IRpcChannelBuffer_FWD_DEFINED__
281 typedef interface IRpcChannelBuffer IRpcChannelBuffer;
282 #endif
283
284 #ifndef RC_INVOKED
285 /* For compatibility only, at least for now */
286 #include <stdlib.h>
287 #endif
288
289 #include <wtypes.h>
290 #include <unknwn.h>
291 #include <objidl.h>
292
293 #include <guiddef.h>
294 #ifndef INITGUID
295 #include <cguid.h>
296 #endif
297
298 #ifdef __cplusplus
299 extern "C" {
300 #endif
301
302 #ifndef NONAMELESSSTRUCT
303 #define LISet32(li, v)   ((li).HighPart = (v) < 0 ? -1 : 0, (li).LowPart = (v))
304 #define ULISet32(li, v)  ((li).HighPart = 0, (li).LowPart = (v))
305 #else
306 #define LISet32(li, v)   ((li).u.HighPart = (v) < 0 ? -1 : 0, (li).u.LowPart = (v))
307 #define ULISet32(li, v)  ((li).u.HighPart = 0, (li).u.LowPart = (v))
308 #endif
309
310 /*****************************************************************************
311  *      Standard API
312  */
313 DWORD WINAPI CoBuildVersion(void);
314
315 typedef enum tagCOINIT
316 {
317     COINIT_APARTMENTTHREADED  = 0x2, /* Apartment model */
318     COINIT_MULTITHREADED      = 0x0, /* OLE calls objects on any thread */
319     COINIT_DISABLE_OLE1DDE    = 0x4, /* Don't use DDE for Ole1 support */
320     COINIT_SPEED_OVER_MEMORY  = 0x8  /* Trade memory for speed */
321 } COINIT;
322
323 HRESULT WINAPI CoInitialize(LPVOID lpReserved);
324 HRESULT WINAPI CoInitializeEx(LPVOID lpReserved, DWORD dwCoInit);
325 void WINAPI CoUninitialize(void);
326 DWORD WINAPI CoGetCurrentProcess(void);
327
328 HINSTANCE WINAPI CoLoadLibrary(LPOLESTR lpszLibName, BOOL bAutoFree);
329 void WINAPI CoFreeAllLibraries(void);
330 void WINAPI CoFreeLibrary(HINSTANCE hLibrary);
331 void WINAPI CoFreeUnusedLibraries(void);
332 void WINAPI CoFreeUnusedLibrariesEx(DWORD dwUnloadDelay, DWORD dwReserved);
333
334 HRESULT WINAPI CoCreateInstance(REFCLSID rclsid, LPUNKNOWN pUnkOuter, DWORD dwClsContext, REFIID iid, LPVOID *ppv);
335 HRESULT WINAPI CoCreateInstanceEx(REFCLSID      rclsid,
336                                   LPUNKNOWN     pUnkOuter,
337                                   DWORD         dwClsContext,
338                                   COSERVERINFO* pServerInfo,
339                                   ULONG         cmq,
340                                   MULTI_QI*     pResults);
341
342 HRESULT WINAPI CoGetInstanceFromFile(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, DWORD grfMode, OLECHAR* pwszName, DWORD dwCount, MULTI_QI* pResults);
343 HRESULT WINAPI CoGetInstanceFromIStorage(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, IStorage* pstg, DWORD dwCount, MULTI_QI* pResults);
344
345 HRESULT WINAPI CoGetMalloc(DWORD dwMemContext, LPMALLOC* lpMalloc);
346 LPVOID WINAPI CoTaskMemAlloc(ULONG size);
347 void WINAPI CoTaskMemFree(LPVOID ptr);
348 LPVOID WINAPI CoTaskMemRealloc(LPVOID ptr, ULONG size);
349
350 HRESULT WINAPI CoRegisterMallocSpy(LPMALLOCSPY pMallocSpy);
351 HRESULT WINAPI CoRevokeMallocSpy(void);
352
353 HRESULT WINAPI CoGetContextToken( ULONG_PTR *token );
354
355 /* class registration flags; passed to CoRegisterClassObject */
356 typedef enum tagREGCLS
357 {
358     REGCLS_SINGLEUSE = 0,
359     REGCLS_MULTIPLEUSE = 1,
360     REGCLS_MULTI_SEPARATE = 2,
361     REGCLS_SUSPENDED = 4,
362     REGCLS_SURROGATE = 8
363 } REGCLS;
364
365 HRESULT WINAPI CoGetClassObject(REFCLSID rclsid, DWORD dwClsContext, COSERVERINFO *pServerInfo, REFIID iid, LPVOID *ppv);
366 HRESULT WINAPI CoRegisterClassObject(REFCLSID rclsid,LPUNKNOWN pUnk,DWORD dwClsContext,DWORD flags,LPDWORD lpdwRegister);
367 HRESULT WINAPI CoRevokeClassObject(DWORD dwRegister);
368 HRESULT WINAPI CoGetPSClsid(REFIID riid,CLSID *pclsid);
369 HRESULT WINAPI CoRegisterPSClsid(REFIID riid, REFCLSID rclsid);
370 HRESULT WINAPI CoRegisterSurrogate(LPSURROGATE pSurrogate);
371 HRESULT WINAPI CoSuspendClassObjects(void);
372 HRESULT WINAPI CoResumeClassObjects(void);
373 ULONG WINAPI CoAddRefServerProcess(void);
374 ULONG WINAPI CoReleaseServerProcess(void);
375
376 /* marshalling */
377 HRESULT WINAPI CoCreateFreeThreadedMarshaler(LPUNKNOWN punkOuter, LPUNKNOWN* ppunkMarshal);
378 HRESULT WINAPI CoGetInterfaceAndReleaseStream(LPSTREAM pStm, REFIID iid, LPVOID* ppv);
379 HRESULT WINAPI CoGetMarshalSizeMax(ULONG* pulSize, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags);
380 HRESULT WINAPI CoGetStandardMarshal(REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags, LPMARSHAL* ppMarshal);
381 HRESULT WINAPI CoMarshalHresult(LPSTREAM pstm, HRESULT hresult);
382 HRESULT WINAPI CoMarshalInterface(LPSTREAM pStm, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags);
383 HRESULT WINAPI CoMarshalInterThreadInterfaceInStream(REFIID riid, LPUNKNOWN pUnk, LPSTREAM* ppStm);
384 HRESULT WINAPI CoReleaseMarshalData(LPSTREAM pStm);
385 HRESULT WINAPI CoDisconnectObject(LPUNKNOWN lpUnk, DWORD reserved);
386 HRESULT WINAPI CoUnmarshalHresult(LPSTREAM pstm, HRESULT* phresult);
387 HRESULT WINAPI CoUnmarshalInterface(LPSTREAM pStm, REFIID riid, LPVOID* ppv);
388 HRESULT WINAPI CoLockObjectExternal(LPUNKNOWN pUnk, BOOL fLock, BOOL fLastUnlockReleases);
389 BOOL WINAPI CoIsHandlerConnected(LPUNKNOWN pUnk);
390
391 /* security */
392 HRESULT WINAPI CoInitializeSecurity(PSECURITY_DESCRIPTOR pSecDesc, LONG cAuthSvc, SOLE_AUTHENTICATION_SERVICE* asAuthSvc, void* pReserved1, DWORD dwAuthnLevel, DWORD dwImpLevel, void* pReserved2, DWORD dwCapabilities, void* pReserved3);
393 HRESULT WINAPI CoGetCallContext(REFIID riid, void** ppInterface);
394 HRESULT WINAPI CoQueryAuthenticationServices(DWORD* pcAuthSvc, SOLE_AUTHENTICATION_SERVICE** asAuthSvc);
395
396 HRESULT WINAPI CoQueryProxyBlanket(IUnknown* pProxy, DWORD* pwAuthnSvc, DWORD* pAuthzSvc, OLECHAR** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTH_IDENTITY_HANDLE* pAuthInfo, DWORD* pCapabilites);
397 HRESULT WINAPI CoSetProxyBlanket(IUnknown* pProxy, DWORD dwAuthnSvc, DWORD dwAuthzSvc, OLECHAR* pServerPrincName, DWORD dwAuthnLevel, DWORD dwImpLevel, RPC_AUTH_IDENTITY_HANDLE pAuthInfo, DWORD dwCapabilities);
398 HRESULT WINAPI CoCopyProxy(IUnknown* pProxy, IUnknown** ppCopy);
399
400 HRESULT WINAPI CoImpersonateClient(void);
401 HRESULT WINAPI CoQueryClientBlanket(DWORD* pAuthnSvc, DWORD* pAuthzSvc, OLECHAR** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTHZ_HANDLE* pPrivs, DWORD* pCapabilities);
402 HRESULT WINAPI CoRevertToSelf(void);
403
404 /* misc */
405 HRESULT WINAPI CoGetTreatAsClass(REFCLSID clsidOld, LPCLSID pClsidNew);
406 HRESULT WINAPI CoTreatAsClass(REFCLSID clsidOld, REFCLSID clsidNew);
407 HRESULT WINAPI CoAllowSetForegroundWindow(IUnknown *pUnk, LPVOID lpvReserved);
408 HRESULT WINAPI CoGetObjectContext(REFIID riid, LPVOID *ppv);
409
410 HRESULT WINAPI CoCreateGuid(GUID* pguid);
411 BOOL WINAPI CoIsOle1Class(REFCLSID rclsid);
412
413 BOOL WINAPI CoDosDateTimeToFileTime(WORD nDosDate, WORD nDosTime, FILETIME* lpFileTime);
414 BOOL WINAPI CoFileTimeToDosDateTime(FILETIME* lpFileTime, WORD* lpDosDate, WORD* lpDosTime);
415 HRESULT WINAPI CoFileTimeNow(FILETIME* lpFileTime);
416 HRESULT WINAPI CoRegisterMessageFilter(LPMESSAGEFILTER lpMessageFilter,LPMESSAGEFILTER *lplpMessageFilter);
417 HRESULT WINAPI CoRegisterChannelHook(REFGUID ExtensionGuid, IChannelHook *pChannelHook);
418
419 typedef enum tagCOWAIT_FLAGS
420 {
421     COWAIT_WAITALL   = 0x00000001,
422     COWAIT_ALERTABLE = 0x00000002
423 } COWAIT_FLAGS;
424
425 HRESULT WINAPI CoWaitForMultipleHandles(DWORD dwFlags,DWORD dwTimeout,ULONG cHandles,LPHANDLE pHandles,LPDWORD lpdwindex);
426
427 /*****************************************************************************
428  *      GUID API
429  */
430 HRESULT WINAPI StringFromCLSID(REFCLSID id, LPOLESTR*);
431 HRESULT WINAPI CLSIDFromString(LPOLESTR, CLSID *);
432 HRESULT WINAPI CLSIDFromProgID(LPCOLESTR progid, LPCLSID riid);
433 HRESULT WINAPI ProgIDFromCLSID(REFCLSID clsid, LPOLESTR *lplpszProgID);
434
435 INT WINAPI StringFromGUID2(REFGUID id, LPOLESTR str, INT cmax);
436
437 /*****************************************************************************
438  *      COM Server dll - exports
439  */
440 HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID * ppv) DECLSPEC_HIDDEN;
441 HRESULT WINAPI DllCanUnloadNow(void) DECLSPEC_HIDDEN;
442
443 /* shouldn't be here, but is nice for type checking */
444 #ifdef __WINESRC__
445 HRESULT WINAPI DllRegisterServer(void) DECLSPEC_HIDDEN;
446 HRESULT WINAPI DllUnregisterServer(void) DECLSPEC_HIDDEN;
447 #endif
448
449
450 /*****************************************************************************
451  *      Data Object
452  */
453 HRESULT WINAPI CreateDataAdviseHolder(LPDATAADVISEHOLDER* ppDAHolder);
454 HRESULT WINAPI CreateDataCache(LPUNKNOWN pUnkOuter, REFCLSID rclsid, REFIID iid, LPVOID* ppv);
455
456 /*****************************************************************************
457  *      Moniker API
458  */
459 HRESULT WINAPI BindMoniker(LPMONIKER pmk, DWORD grfOpt, REFIID iidResult, LPVOID* ppvResult);
460 HRESULT WINAPI CoGetObject(LPCWSTR pszName, BIND_OPTS *pBindOptions, REFIID riid, void **ppv);
461 HRESULT WINAPI CreateAntiMoniker(LPMONIKER * ppmk);
462 HRESULT WINAPI CreateBindCtx(DWORD reserved, LPBC* ppbc);
463 HRESULT WINAPI CreateClassMoniker(REFCLSID rclsid, LPMONIKER* ppmk);
464 HRESULT WINAPI CreateFileMoniker(LPCOLESTR lpszPathName, LPMONIKER* ppmk);
465 HRESULT WINAPI CreateGenericComposite(LPMONIKER pmkFirst, LPMONIKER pmkRest, LPMONIKER* ppmkComposite);
466 HRESULT WINAPI CreateItemMoniker(LPCOLESTR lpszDelim, LPCOLESTR  lpszItem, LPMONIKER* ppmk);
467 HRESULT WINAPI CreateObjrefMoniker(LPUNKNOWN punk, LPMONIKER * ppmk);
468 HRESULT WINAPI CreatePointerMoniker(LPUNKNOWN punk, LPMONIKER * ppmk);
469 HRESULT WINAPI GetClassFile(LPCOLESTR filePathName,CLSID *pclsid);
470 HRESULT WINAPI GetRunningObjectTable(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot);
471 HRESULT WINAPI MkParseDisplayName(LPBC pbc, LPCOLESTR szUserName, ULONG * pchEaten, LPMONIKER * ppmk);
472 HRESULT WINAPI MonikerCommonPrefixWith(IMoniker* pmkThis,IMoniker* pmkOther,IMoniker** ppmkCommon);
473 HRESULT WINAPI MonikerRelativePathTo(LPMONIKER pmkSrc, LPMONIKER pmkDest, LPMONIKER * ppmkRelPath, BOOL dwReserved);
474
475 /*****************************************************************************
476  *      Storage API
477  */
478 #define STGM_DIRECT             0x00000000
479 #define STGM_TRANSACTED         0x00010000
480 #define STGM_SIMPLE             0x08000000
481 #define STGM_READ               0x00000000
482 #define STGM_WRITE              0x00000001
483 #define STGM_READWRITE          0x00000002
484 #define STGM_SHARE_DENY_NONE    0x00000040
485 #define STGM_SHARE_DENY_READ    0x00000030
486 #define STGM_SHARE_DENY_WRITE   0x00000020
487 #define STGM_SHARE_EXCLUSIVE    0x00000010
488 #define STGM_PRIORITY           0x00040000
489 #define STGM_DELETEONRELEASE    0x04000000
490 #define STGM_CREATE             0x00001000
491 #define STGM_CONVERT            0x00020000
492 #define STGM_FAILIFTHERE        0x00000000
493 #define STGM_NOSCRATCH          0x00100000
494 #define STGM_NOSNAPSHOT         0x00200000
495 #define STGM_DIRECT_SWMR        0x00400000
496
497 #define STGFMT_STORAGE          0
498 #define STGFMT_FILE             3
499 #define STGFMT_ANY              4
500 #define STGFMT_DOCFILE  5
501
502 typedef struct tagSTGOPTIONS
503 {
504     USHORT usVersion;
505     USHORT reserved;
506     ULONG ulSectorSize;
507     const WCHAR* pwcsTemplateFile;
508 } STGOPTIONS;
509
510 HRESULT WINAPI StgCreateDocfile(LPCOLESTR pwcsName,DWORD grfMode,DWORD reserved,IStorage **ppstgOpen);
511 HRESULT WINAPI StgCreateStorageEx(const WCHAR*,DWORD,DWORD,DWORD,STGOPTIONS*,void*,REFIID,void**);
512 HRESULT WINAPI StgIsStorageFile(LPCOLESTR fn);
513 HRESULT WINAPI StgIsStorageILockBytes(ILockBytes *plkbyt);
514 HRESULT WINAPI StgOpenStorage(const OLECHAR* pwcsName,IStorage* pstgPriority,DWORD grfMode,SNB snbExclude,DWORD reserved,IStorage**ppstgOpen);
515 HRESULT WINAPI StgOpenStorageEx(const WCHAR* pwcwName,DWORD grfMode,DWORD stgfmt,DWORD grfAttrs,STGOPTIONS *pStgOptions, void *reserved, REFIID riid, void **ppObjectOpen);
516
517 HRESULT WINAPI StgCreateDocfileOnILockBytes(ILockBytes *plkbyt,DWORD grfMode, DWORD reserved, IStorage** ppstgOpen);
518 HRESULT WINAPI StgOpenStorageOnILockBytes(ILockBytes *plkbyt, IStorage *pstgPriority, DWORD grfMode, SNB snbExclude, DWORD reserved, IStorage **ppstgOpen);
519 HRESULT WINAPI StgSetTimes( OLECHAR const *lpszName, FILETIME const *pctime, FILETIME const *patime, FILETIME const *pmtime);
520
521 #ifdef __cplusplus
522 }
523 #endif
524
525 #ifndef __WINESRC__
526 # include <urlmon.h>
527 #endif
528 #include <propidl.h>
529
530 #ifndef __WINESRC__
531
532 #define FARSTRUCT
533 #define HUGEP
534
535 #define WINOLEAPI        STDAPI
536 #define WINOLEAPI_(type) STDAPI_(type)
537
538 #endif /* __WINESRC__ */
539
540 #endif /* _OBJBASE_H_ */