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 #if defined(__cplusplus) && !defined(CINTERFACE)
 174
 175 #ifdef COM_STDMETHOD_CAN_THROW
 176 # define COM_DECLSPEC_NOTHROW
 177 #else
 178 # define COM_DECLSPEC_NOTHROW DECLSPEC_NOTHROW
 179 #endif
 180
 181 /* C++ interface */
 182
 183 #define STDMETHOD(method)        virtual COM_DECLSPEC_NOTHROW HRESULT STDMETHODCALLTYPE method
 184 #define STDMETHOD_(type,method)  virtual COM_DECLSPEC_NOTHROW type STDMETHODCALLTYPE method
 185 #define STDMETHODV(method)       virtual COM_DECLSPEC_NOTHROW HRESULT STDMETHODVCALLTYPE method
 186 #define STDMETHODV_(type,method) virtual COM_DECLSPEC_NOTHROW type STDMETHODVCALLTYPE method
 187
 188 #define PURE   = 0
 189 #define THIS_
 190 #define THIS   void
 191
 192 #define interface struct
 193 #define DECLARE_INTERFACE(iface)        interface DECLSPEC_NOVTABLE iface
 194 #define DECLARE_INTERFACE_(iface,ibase) interface DECLSPEC_NOVTABLE iface : public ibase
 195 #define DECLARE_INTERFACE_IID_(iface, ibase, iid) interface DECLSPEC_UUID(iid) DECLSPEC_NOVTABLE iface : public ibase
 196
 197 #define BEGIN_INTERFACE
 198 #define END_INTERFACE
 199
 200 #else  /* __cplusplus && !CINTERFACE */
 201
 202 /* C interface */
 203
 204 #define STDMETHOD(method)        HRESULT (STDMETHODCALLTYPE *method)
 205 #define STDMETHOD_(type,method)  type (STDMETHODCALLTYPE *method)
 206 #define STDMETHODV(method)       HRESULT (STDMETHODVCALLTYPE *method)
 207 #define STDMETHODV_(type,method) type (STDMETHODVCALLTYPE *method)
 208
 209 #define PURE
 210 #define THIS_ INTERFACE *This,
 211 #define THIS  INTERFACE *This
 212
 213 #define interface struct
 214
 215 #ifdef __WINESRC__
 216 #define CONST_VTABLE
 217 #endif
 218
 219 #ifdef CONST_VTABLE
 220 #undef CONST_VTBL
 221 #define CONST_VTBL const
 222 #define DECLARE_INTERFACE(iface) \
 223          typedef interface iface { const struct iface##Vtbl *lpVtbl; } iface; \
 224          typedef struct iface##Vtbl iface##Vtbl; \
 225          struct iface##Vtbl
 226 #else
 227 #undef CONST_VTBL
 228 #define CONST_VTBL
 229 #define DECLARE_INTERFACE(iface) \
 230          typedef interface iface { struct iface##Vtbl *lpVtbl; } iface; \
 231          typedef struct iface##Vtbl iface##Vtbl; \
 232          struct iface##Vtbl
 233 #endif
 234 #define DECLARE_INTERFACE_(iface,ibase) DECLARE_INTERFACE(iface)
 235 #define DECLARE_INTERFACE_IID_(iface, ibase, iid) DECLARE_INTERFACE_(iface, ibase)
 236
 237 #define BEGIN_INTERFACE
 238 #define END_INTERFACE
 239
 240 #endif  /* __cplusplus && !CINTERFACE */
 241
 242 #ifndef __IRpcStubBuffer_FWD_DEFINED__
 243 #define __IRpcStubBuffer_FWD_DEFINED__
 244 typedef interface IRpcStubBuffer IRpcStubBuffer;
 245 #endif
 246 #ifndef __IRpcChannelBuffer_FWD_DEFINED__
 247 #define __IRpcChannelBuffer_FWD_DEFINED__
 248 typedef interface IRpcChannelBuffer IRpcChannelBuffer;
 249 #endif
 250
 251 #ifndef RC_INVOKED
 252 /* For compatibility only, at least for now */
 253 #include <stdlib.h>
 254 #endif
 255
 256 #include <wtypes.h>
 257 #include <unknwn.h>
 258 #include <objidl.h>
 259
 260 #include <guiddef.h>
 261 #ifndef INITGUID
 262 #include <cguid.h>
 263 #endif
 264
 265 #ifdef __cplusplus
 266 extern "C" {
 267 #endif
 268
 269 #ifndef NONAMELESSSTRUCT
 270 #define LISet32(li, v)   ((li).HighPart = (v) < 0 ? -1 : 0, (li).LowPart = (v))
 271 #define ULISet32(li, v)  ((li).HighPart = 0, (li).LowPart = (v))
 272 #else
 273 #define LISet32(li, v)   ((li).u.HighPart = (v) < 0 ? -1 : 0, (li).u.LowPart = (v))
 274 #define ULISet32(li, v)  ((li).u.HighPart = 0, (li).u.LowPart = (v))
 275 #endif
 276
 277 /*****************************************************************************
 278  *      Standard API
 279  */
 280 DWORD WINAPI CoBuildVersion(void);
 281
 282 typedef enum tagCOINIT
 283 {
 284     COINIT_APARTMENTTHREADED  = 0x2, /* Apartment model */
 285     COINIT_MULTITHREADED      = 0x0, /* OLE calls objects on any thread */
 286     COINIT_DISABLE_OLE1DDE    = 0x4, /* Don't use DDE for Ole1 support */
 287     COINIT_SPEED_OVER_MEMORY  = 0x8  /* Trade memory for speed */
 288 } COINIT;
 289
 290 HRESULT WINAPI CoInitialize(LPVOID lpReserved);
 291 HRESULT WINAPI CoInitializeEx(LPVOID lpReserved, DWORD dwCoInit);
 292 void WINAPI CoUninitialize(void);
 293 DWORD WINAPI CoGetCurrentProcess(void);
 294 HRESULT WINAPI CoGetCurrentLogicalThreadId(GUID *id);
 295 HRESULT WINAPI CoGetApartmentType(APTTYPE *type, APTTYPEQUALIFIER *qualifier);
 296
 297 HINSTANCE WINAPI CoLoadLibrary(LPOLESTR lpszLibName, BOOL bAutoFree);
 298 void WINAPI CoFreeAllLibraries(void);
 299 void WINAPI CoFreeLibrary(HINSTANCE hLibrary);
 300 void WINAPI CoFreeUnusedLibraries(void);
 301 void WINAPI CoFreeUnusedLibrariesEx(DWORD dwUnloadDelay, DWORD dwReserved);
 302
 303 HRESULT WINAPI CoCreateInstance(REFCLSID rclsid, LPUNKNOWN pUnkOuter, DWORD dwClsContext, REFIID iid, LPVOID *ppv);
 304 HRESULT WINAPI CoCreateInstanceEx(REFCLSID      rclsid,
 305                                   LPUNKNOWN     pUnkOuter,
 306                                   DWORD         dwClsContext,
 307                                   COSERVERINFO* pServerInfo,
 308                                   ULONG         cmq,
 309                                   MULTI_QI*     pResults);
 310
 311 HRESULT WINAPI CoGetInstanceFromFile(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, DWORD grfMode, OLECHAR* pwszName, DWORD dwCount, MULTI_QI* pResults);
 312 HRESULT WINAPI CoGetInstanceFromIStorage(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, IStorage* pstg, DWORD dwCount, MULTI_QI* pResults);
 313
 314 HRESULT WINAPI CoGetMalloc(DWORD dwMemContext, LPMALLOC* lpMalloc);
 315 LPVOID WINAPI CoTaskMemAlloc(SIZE_T size) __WINE_ALLOC_SIZE(1);
 316 void WINAPI CoTaskMemFree(LPVOID ptr);
 317 LPVOID WINAPI CoTaskMemRealloc(LPVOID ptr, SIZE_T size);
 318
 319 HRESULT WINAPI CoRegisterMallocSpy(LPMALLOCSPY pMallocSpy);
 320 HRESULT WINAPI CoRevokeMallocSpy(void);
 321
 322 HRESULT WINAPI CoGetContextToken( ULONG_PTR *token );
 323
 324 /* class registration flags; passed to CoRegisterClassObject */
 325 typedef enum tagREGCLS
 326 {
 327     REGCLS_SINGLEUSE = 0,
 328     REGCLS_MULTIPLEUSE = 1,
 329     REGCLS_MULTI_SEPARATE = 2,
 330     REGCLS_SUSPENDED = 4,
 331     REGCLS_SURROGATE = 8
 332 } REGCLS;
 333
 334 HRESULT WINAPI CoGetClassObject(REFCLSID rclsid, DWORD dwClsContext, COSERVERINFO *pServerInfo, REFIID iid, LPVOID *ppv);
 335 HRESULT WINAPI CoRegisterClassObject(REFCLSID rclsid,LPUNKNOWN pUnk,DWORD dwClsContext,DWORD flags,LPDWORD lpdwRegister);
 336 HRESULT WINAPI CoRevokeClassObject(DWORD dwRegister);
 337 HRESULT WINAPI CoGetPSClsid(REFIID riid,CLSID *pclsid);
 338 HRESULT WINAPI CoRegisterPSClsid(REFIID riid, REFCLSID rclsid);
 339 HRESULT WINAPI CoRegisterSurrogate(LPSURROGATE pSurrogate);
 340 HRESULT WINAPI CoSuspendClassObjects(void);
 341 HRESULT WINAPI CoResumeClassObjects(void);
 342 ULONG WINAPI CoAddRefServerProcess(void);
 343 ULONG WINAPI CoReleaseServerProcess(void);
 344
 345 /* marshalling */
 346 HRESULT WINAPI CoCreateFreeThreadedMarshaler(LPUNKNOWN punkOuter, LPUNKNOWN* ppunkMarshal);
 347 HRESULT WINAPI CoGetInterfaceAndReleaseStream(LPSTREAM pStm, REFIID iid, LPVOID* ppv);
 348 HRESULT WINAPI CoGetMarshalSizeMax(ULONG* pulSize, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags);
 349 HRESULT WINAPI CoGetStandardMarshal(REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags, LPMARSHAL* ppMarshal);
 350 HRESULT WINAPI CoMarshalHresult(LPSTREAM pstm, HRESULT hresult);
 351 HRESULT WINAPI CoMarshalInterface(LPSTREAM pStm, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags);
 352 HRESULT WINAPI CoMarshalInterThreadInterfaceInStream(REFIID riid, LPUNKNOWN pUnk, LPSTREAM* ppStm);
 353 HRESULT WINAPI CoReleaseMarshalData(LPSTREAM pStm);
 354 HRESULT WINAPI CoDisconnectObject(LPUNKNOWN lpUnk, DWORD reserved);
 355 HRESULT WINAPI CoUnmarshalHresult(LPSTREAM pstm, HRESULT* phresult);
 356 HRESULT WINAPI CoUnmarshalInterface(LPSTREAM pStm, REFIID riid, LPVOID* ppv);
 357 HRESULT WINAPI CoLockObjectExternal(LPUNKNOWN pUnk, BOOL fLock, BOOL fLastUnlockReleases);
 358 BOOL WINAPI CoIsHandlerConnected(LPUNKNOWN pUnk);
 359 HRESULT WINAPI CoDisableCallCancellation(void *reserved);
 360 HRESULT WINAPI CoEnableCallCancellation(void *reserved);
 361
 362 /* security */
 363 HRESULT WINAPI CoInitializeSecurity(PSECURITY_DESCRIPTOR pSecDesc, LONG cAuthSvc, SOLE_AUTHENTICATION_SERVICE* asAuthSvc, void* pReserved1, DWORD dwAuthnLevel, DWORD dwImpLevel, void* pReserved2, DWORD dwCapabilities, void* pReserved3);
 364 HRESULT WINAPI CoGetCallContext(REFIID riid, void** ppInterface);
 365 HRESULT WINAPI CoSwitchCallContext(IUnknown *pContext, IUnknown **ppOldContext);
 366 HRESULT WINAPI CoQueryAuthenticationServices(DWORD* pcAuthSvc, SOLE_AUTHENTICATION_SERVICE** asAuthSvc);
 367
 368 HRESULT WINAPI CoQueryProxyBlanket(IUnknown* pProxy, DWORD* pwAuthnSvc, DWORD* pAuthzSvc, OLECHAR** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTH_IDENTITY_HANDLE* pAuthInfo, DWORD* pCapabilities);
 369 HRESULT WINAPI CoSetProxyBlanket(IUnknown* pProxy, DWORD dwAuthnSvc, DWORD dwAuthzSvc, OLECHAR* pServerPrincName, DWORD dwAuthnLevel, DWORD dwImpLevel, RPC_AUTH_IDENTITY_HANDLE pAuthInfo, DWORD dwCapabilities);
 370 HRESULT WINAPI CoCopyProxy(IUnknown* pProxy, IUnknown** ppCopy);
 371
 372 HRESULT WINAPI CoImpersonateClient(void);
 373 HRESULT WINAPI CoQueryClientBlanket(DWORD* pAuthnSvc, DWORD* pAuthzSvc, OLECHAR** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTHZ_HANDLE* pPrivs, DWORD* pCapabilities);
 374 HRESULT WINAPI CoRevertToSelf(void);
 375
 376 /* misc */
 377 HRESULT WINAPI CoGetTreatAsClass(REFCLSID clsidOld, LPCLSID pClsidNew);
 378 HRESULT WINAPI CoTreatAsClass(REFCLSID clsidOld, REFCLSID clsidNew);
 379 HRESULT WINAPI CoAllowSetForegroundWindow(IUnknown *pUnk, LPVOID lpvReserved);
 380 HRESULT WINAPI CoGetObjectContext(REFIID riid, LPVOID *ppv);
 381 HRESULT WINAPI CoRegisterInitializeSpy(IInitializeSpy *spy, ULARGE_INTEGER *cookie);
 382 HRESULT WINAPI CoRevokeInitializeSpy(ULARGE_INTEGER cookie);
 383
 384 HRESULT WINAPI CoCreateGuid(GUID* pguid);
 385 BOOL WINAPI CoIsOle1Class(REFCLSID rclsid);
 386
 387 BOOL WINAPI CoDosDateTimeToFileTime(WORD nDosDate, WORD nDosTime, FILETIME* lpFileTime);
 388 BOOL WINAPI CoFileTimeToDosDateTime(FILETIME* lpFileTime, WORD* lpDosDate, WORD* lpDosTime);
 389 HRESULT WINAPI CoFileTimeNow(FILETIME* lpFileTime);
 390 HRESULT WINAPI CoRegisterMessageFilter(LPMESSAGEFILTER lpMessageFilter,LPMESSAGEFILTER *lplpMessageFilter);
 391 HRESULT WINAPI CoRegisterChannelHook(REFGUID ExtensionGuid, IChannelHook *pChannelHook);
 392
 393 typedef enum tagCOWAIT_FLAGS
 394 {
 395     COWAIT_WAITALL        = 0x00000001,
 396     COWAIT_ALERTABLE      = 0x00000002,
 397     COWAIT_INPUTAVAILABLE = 0x00000004
 398 } COWAIT_FLAGS;
 399
 400 HRESULT WINAPI CoWaitForMultipleHandles(DWORD dwFlags,DWORD dwTimeout,ULONG cHandles,LPHANDLE pHandles,LPDWORD lpdwindex);
 401
 402 /*****************************************************************************
 403  *      GUID API
 404  */
 405 HRESULT WINAPI StringFromCLSID(REFCLSID id, LPOLESTR*);
 406 HRESULT WINAPI CLSIDFromString(LPCOLESTR, LPCLSID);
 407 HRESULT WINAPI CLSIDFromProgID(LPCOLESTR progid, LPCLSID riid);
 408 HRESULT WINAPI ProgIDFromCLSID(REFCLSID clsid, LPOLESTR *lplpszProgID);
 409 INT WINAPI StringFromGUID2(REFGUID id, LPOLESTR str, INT cmax);
 410 HRESULT WINAPI IIDFromString(LPCOLESTR str, IID *iid);
 411 HRESULT WINAPI StringFromIID(REFIID riid, LPOLESTR*);
 412
 413 /*****************************************************************************
 414  *      COM Server dll - exports
 415  */
 416 HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID * ppv) DECLSPEC_HIDDEN;
 417 HRESULT WINAPI DllCanUnloadNow(void) DECLSPEC_HIDDEN;
 418
 419 /* shouldn't be here, but is nice for type checking */
 420 #ifdef __WINESRC__
 421 HRESULT WINAPI DllRegisterServer(void) DECLSPEC_HIDDEN;
 422 HRESULT WINAPI DllUnregisterServer(void) DECLSPEC_HIDDEN;
 423 #endif
 424
 425
 426 /*****************************************************************************
 427  *      Data Object
 428  */
 429 HRESULT WINAPI CreateDataAdviseHolder(LPDATAADVISEHOLDER* ppDAHolder);
 430 HRESULT WINAPI CreateDataCache(LPUNKNOWN pUnkOuter, REFCLSID rclsid, REFIID iid, LPVOID* ppv);
 431
 432 /*****************************************************************************
 433  *      Moniker API
 434  */
 435 HRESULT WINAPI BindMoniker(LPMONIKER pmk, DWORD grfOpt, REFIID iidResult, LPVOID* ppvResult);
 436 HRESULT WINAPI CoGetObject(LPCWSTR pszName, BIND_OPTS *pBindOptions, REFIID riid, void **ppv);
 437 HRESULT WINAPI CreateAntiMoniker(LPMONIKER * ppmk);
 438 HRESULT WINAPI CreateBindCtx(DWORD reserved, LPBC* ppbc);
 439 HRESULT WINAPI CreateClassMoniker(REFCLSID rclsid, LPMONIKER* ppmk);
 440 HRESULT WINAPI CreateFileMoniker(LPCOLESTR lpszPathName, LPMONIKER* ppmk);
 441 HRESULT WINAPI CreateGenericComposite(LPMONIKER pmkFirst, LPMONIKER pmkRest, LPMONIKER* ppmkComposite);
 442 HRESULT WINAPI CreateItemMoniker(LPCOLESTR lpszDelim, LPCOLESTR  lpszItem, LPMONIKER* ppmk);
 443 HRESULT WINAPI CreateObjrefMoniker(LPUNKNOWN punk, LPMONIKER * ppmk);
 444 HRESULT WINAPI CreatePointerMoniker(LPUNKNOWN punk, LPMONIKER * ppmk);
 445 HRESULT WINAPI GetClassFile(LPCOLESTR filePathName,CLSID *pclsid);
 446 HRESULT WINAPI GetRunningObjectTable(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot);
 447 HRESULT WINAPI MkParseDisplayName(LPBC pbc, LPCOLESTR szUserName, ULONG * pchEaten, LPMONIKER * ppmk);
 448 HRESULT WINAPI MonikerCommonPrefixWith(IMoniker* pmkThis,IMoniker* pmkOther,IMoniker** ppmkCommon);
 449 HRESULT WINAPI MonikerRelativePathTo(LPMONIKER pmkSrc, LPMONIKER pmkDest, LPMONIKER * ppmkRelPath, BOOL dwReserved);
 450
 451 /*****************************************************************************
 452  *      Storage API
 453  */
 454 #define STGM_DIRECT             0x00000000
 455 #define STGM_TRANSACTED         0x00010000
 456 #define STGM_SIMPLE             0x08000000
 457 #define STGM_READ               0x00000000
 458 #define STGM_WRITE              0x00000001
 459 #define STGM_READWRITE          0x00000002
 460 #define STGM_SHARE_DENY_NONE    0x00000040
 461 #define STGM_SHARE_DENY_READ    0x00000030
 462 #define STGM_SHARE_DENY_WRITE   0x00000020
 463 #define STGM_SHARE_EXCLUSIVE    0x00000010
 464 #define STGM_PRIORITY           0x00040000
 465 #define STGM_DELETEONRELEASE    0x04000000
 466 #define STGM_CREATE             0x00001000
 467 #define STGM_CONVERT            0x00020000
 468 #define STGM_FAILIFTHERE        0x00000000
 469 #define STGM_NOSCRATCH          0x00100000
 470 #define STGM_NOSNAPSHOT         0x00200000
 471 #define STGM_DIRECT_SWMR        0x00400000
 472
 473 #define STGFMT_STORAGE          0
 474 #define STGFMT_FILE             3
 475 #define STGFMT_ANY              4
 476 #define STGFMT_DOCFILE  5
 477
 478 typedef struct tagSTGOPTIONS
 479 {
 480     USHORT usVersion;
 481     USHORT reserved;
 482     ULONG ulSectorSize;
 483     const WCHAR* pwcsTemplateFile;
 484 } STGOPTIONS;
 485
 486 HRESULT WINAPI StgCreateDocfile(LPCOLESTR pwcsName,DWORD grfMode,DWORD reserved,IStorage **ppstgOpen);
 487 HRESULT WINAPI StgCreateStorageEx(const WCHAR*,DWORD,DWORD,DWORD,STGOPTIONS*,void*,REFIID,void**);
 488 HRESULT WINAPI StgIsStorageFile(LPCOLESTR fn);
 489 HRESULT WINAPI StgIsStorageILockBytes(ILockBytes *plkbyt);
 490 HRESULT WINAPI StgOpenStorage(const OLECHAR* pwcsName,IStorage* pstgPriority,DWORD grfMode,SNB snbExclude,DWORD reserved,IStorage**ppstgOpen);
 491 HRESULT WINAPI StgOpenStorageEx(const WCHAR* pwcwName,DWORD grfMode,DWORD stgfmt,DWORD grfAttrs,STGOPTIONS *pStgOptions, void *reserved, REFIID riid, void **ppObjectOpen);
 492
 493 HRESULT WINAPI StgCreateDocfileOnILockBytes(ILockBytes *plkbyt,DWORD grfMode, DWORD reserved, IStorage** ppstgOpen);
 494 HRESULT WINAPI StgOpenStorageOnILockBytes(ILockBytes *plkbyt, IStorage *pstgPriority, DWORD grfMode, SNB snbExclude, DWORD reserved, IStorage **ppstgOpen);
 495 HRESULT WINAPI StgSetTimes( OLECHAR const *lpszName, FILETIME const *pctime, FILETIME const *patime, FILETIME const *pmtime);
 496
 497 #ifdef __cplusplus
 498 }
 499 #endif
 500
 501 #ifndef __WINESRC__
 502 # include <urlmon.h>
 503 #endif
 504 #include <propidl.h>
 505
 506 #ifndef __WINESRC__
 507
 508 #define FARSTRUCT
 509 #define HUGEP
 510
 511 #define WINOLEAPI        STDAPI
 512 #define WINOLEAPI_(type) STDAPI_(type)
 513
 514 #endif /* __WINESRC__ */
 515
 516 #endif /* _OBJBASE_H_ */