2002-03-10 00:29:33 +01:00
|
|
|
|
/*
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* Copyright (C) 1998-1999 Fran<EFBFBD>ois Gouget
|
2002-03-10 00:29:33 +01:00
|
|
|
|
*
|
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
|
*
|
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
|
*
|
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
|
* License along with this library; if not, write to the Free Software
|
|
|
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
|
*/
|
|
|
|
|
|
2002-12-05 23:11:43 +01:00
|
|
|
|
#include "rpc.h"
|
|
|
|
|
#include "rpcndr.h"
|
1998-12-18 17:00:03 +01:00
|
|
|
|
|
2002-12-05 23:11:43 +01:00
|
|
|
|
#ifndef _OBJBASE_H_
|
1999-06-05 17:23:20 +02:00
|
|
|
|
#define _OBJBASE_H_
|
1998-12-18 17:00:03 +01:00
|
|
|
|
|
2002-12-23 02:41:51 +01:00
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* define ICOM_MSVTABLE_COMPAT
|
|
|
|
|
* to implement the microsoft com vtable compatibility workaround for g++.
|
|
|
|
|
*
|
|
|
|
|
* NOTE: Turning this option on will produce a winelib that is incompatible
|
|
|
|
|
* with the binary emulator.
|
|
|
|
|
*
|
|
|
|
|
* If the compiler supports the com_interface attribute, leave this off, and
|
|
|
|
|
* define the ICOM_USE_COM_INTERFACE_ATTRIBUTE macro below. This may also
|
|
|
|
|
* require the addition of the -vtable-thunks option for g++.
|
|
|
|
|
*
|
|
|
|
|
* If you aren't interested in Winelib C++ compatibility at all, leave both
|
|
|
|
|
* options off.
|
|
|
|
|
*
|
|
|
|
|
* The preferable method for using ICOM_USE_COM_INTERFACE_ATTRIBUTE macro
|
|
|
|
|
* would be to define it only for your Winelib application. This allows you
|
|
|
|
|
* to have both binary and Winelib compatibility for C and C++ at the same
|
|
|
|
|
* time :)
|
|
|
|
|
*/
|
|
|
|
|
/* #define ICOM_MSVTABLE_COMPAT 1 */
|
|
|
|
|
/* #define ICOM_USE_COM_INTERFACE_ATTRIBUTE 1 */
|
|
|
|
|
|
2000-10-19 22:32:18 +02:00
|
|
|
|
|
2002-12-23 02:41:51 +01:00
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* Macros to define a COM interface
|
|
|
|
|
*/
|
|
|
|
|
/*
|
|
|
|
|
* The goal of the following set of definitions is to provide a way to use the same
|
|
|
|
|
* header file definitions to provide both a C interface and a C++ object oriented
|
|
|
|
|
* interface to COM interfaces. The type of interface is selected automatically
|
|
|
|
|
* depending on the language but it is always possible to get the C interface in C++
|
|
|
|
|
* by defining CINTERFACE.
|
|
|
|
|
*
|
|
|
|
|
* It is based on the following assumptions:
|
|
|
|
|
* - all COM interfaces derive from IUnknown, this should not be a problem.
|
|
|
|
|
* - the header file only defines the interface, the actual fields are defined
|
|
|
|
|
* separately in the C file implementing the interface.
|
|
|
|
|
*
|
|
|
|
|
* The natural approach to this problem would be to make sure we get a C++ class and
|
|
|
|
|
* virtual methods in C++ and a structure with a table of pointer to functions in C.
|
|
|
|
|
* Unfortunately the layout of the virtual table is compiler specific, the layout of
|
|
|
|
|
* g++ virtual tables is not the same as that of an egcs virtual table which is not the
|
|
|
|
|
* same as that generated by Visual C+. There are workarounds to make the virtual tables
|
|
|
|
|
* compatible via padding but unfortunately the one which is imposed to the WINE emulator
|
|
|
|
|
* by the Windows binaries, i.e. the Visual C++ one, is the most compact of all.
|
|
|
|
|
*
|
|
|
|
|
* So the solution I finally adopted does not use virtual tables. Instead I use inline
|
|
|
|
|
* non virtual methods that dereference the method pointer themselves and perform the call.
|
|
|
|
|
*
|
|
|
|
|
* Let's take Direct3D as an example:
|
|
|
|
|
*
|
2003-04-10 02:19:24 +02:00
|
|
|
|
* #define INTERFACE IDirect3D
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* #define IDirect3D_METHODS \
|
2003-04-11 02:31:02 +02:00
|
|
|
|
* IUnknown_METHODS \
|
2003-04-10 02:19:24 +02:00
|
|
|
|
* STDMETHOD(Initialize)(THIS_ REFIID) PURE; \
|
|
|
|
|
* STDMETHOD(EnumDevices)(THIS_ LPD3DENUMDEVICESCALLBACK, LPVOID) PURE; \
|
|
|
|
|
* STDMETHOD(CreateLight)(THIS_ LPDIRECT3DLIGHT*, IUnknown*) PURE; \
|
|
|
|
|
* STDMETHOD(CreateMaterial)(THIS_ LPDIRECT3DMATERIAL*, IUnknown*) PURE; \
|
|
|
|
|
* STDMETHOD(CreateViewport)(THIS_ LPDIRECT3DVIEWPORT*, IUnknown*) PURE; \
|
|
|
|
|
* STDMETHOD(FindDevice)(THIS_ LPD3DFINDDEVICESEARCH, LPD3DFINDDEVICERESULT) PURE;
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* ICOM_DEFINE(IDirect3D,IUnknown)
|
2003-04-10 02:19:24 +02:00
|
|
|
|
* #undef INTERFACE
|
2002-12-23 02:41:51 +01:00
|
|
|
|
*
|
2003-04-10 23:13:58 +02:00
|
|
|
|
* #ifdef COBJMACROS
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* // *** IUnknown methods *** //
|
2003-04-10 23:13:58 +02:00
|
|
|
|
* #define IDirect3D_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
|
|
|
|
|
* #define IDirect3D_AddRef(p) (p)->lpVtbl->AddRef(p)
|
|
|
|
|
* #define IDirect3D_Release(p) (p)->lpVtbl->Release(p)
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* // *** IDirect3D methods *** //
|
2003-04-10 23:13:58 +02:00
|
|
|
|
* #define IDirect3D_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
|
|
|
|
|
* #define IDirect3D_EnumDevices(p,a,b) (p)->lpVtbl->EnumDevice(p,a,b)
|
|
|
|
|
* #define IDirect3D_CreateLight(p,a,b) (p)->lpVtbl->CreateLight(p,a,b)
|
|
|
|
|
* #define IDirect3D_CreateMaterial(p,a,b) (p)->lpVtbl->CreateMaterial(p,a,b)
|
|
|
|
|
* #define IDirect3D_CreateViewport(p,a,b) (p)->lpVtbl->CreateViewport(p,a,b)
|
|
|
|
|
* #define IDirect3D_FindDevice(p,a,b) (p)->lpVtbl->FindDevice(p,a,b)
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* #endif
|
|
|
|
|
*
|
|
|
|
|
* Comments:
|
2003-04-10 02:19:24 +02:00
|
|
|
|
* - The INTERFACE macro is used in the STDMETHOD macros to define the type of the 'this'
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* pointer. Defining this macro here saves us the trouble of having to repeat the interface
|
2003-04-10 02:19:24 +02:00
|
|
|
|
* name everywhere. Note however that because of the way macros work, a macro like STDMETHOD
|
|
|
|
|
* cannot use 'INTERFACE##_VTABLE' because this would give 'INTERFACE_VTABLE' and not
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* 'IDirect3D_VTABLE'.
|
2003-04-11 02:31:02 +02:00
|
|
|
|
* - ICOM_METHODS defines the list of methods that are inheritable from this interface. It must
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* be written manually (rather than using a macro to generate the equivalent code) to avoid
|
2003-04-11 02:31:02 +02:00
|
|
|
|
* macro recursion (which compilers don't like). It must start with the METHODS definition
|
|
|
|
|
* of the parent interface so that method inheritance works properly.
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* - The ICOM_DEFINE finally declares all the structures necessary for the interface. We have to
|
|
|
|
|
* explicitly use the interface name for macro expansion reasons again.
|
2003-04-10 02:19:24 +02:00
|
|
|
|
* - The 'undef INTERFACE' is here to remind you that using INTERFACE in the following macros
|
2003-04-10 23:13:58 +02:00
|
|
|
|
* will not work.
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* - Finally the set of 'IDirect3D_Xxx' macros is a standard set of macros defined to ease access
|
|
|
|
|
* to the interface methods in C. Unfortunately I don't see any way to avoid having to duplicate
|
|
|
|
|
* the inherited method definitions there. This time I could have used a trick to use only one
|
|
|
|
|
* macro whatever the number of parameters but I prefered to have it work the same way as above.
|
|
|
|
|
* - You probably have noticed that we don't define the fields we need to actually implement this
|
|
|
|
|
* interface: reference count, pointer to other resources and miscellaneous fields. That's
|
|
|
|
|
* because these interfaces are just that: interfaces. They may be implemented more than once, in
|
|
|
|
|
* different contexts and sometimes not even in Wine. Thus it would not make sense to impose
|
|
|
|
|
* that the interface contains some specific fields.
|
|
|
|
|
*
|
|
|
|
|
*
|
|
|
|
|
* In C this gives:
|
|
|
|
|
* typedef struct IDirect3DVtbl IDirect3DVtbl;
|
|
|
|
|
* struct IDirect3D {
|
|
|
|
|
* IDirect3DVtbl* lpVtbl;
|
|
|
|
|
* };
|
|
|
|
|
* struct IDirect3DVtbl {
|
|
|
|
|
* HRESULT (*QueryInterface)(IDirect3D* me, REFIID riid, LPVOID* ppvObj);
|
|
|
|
|
* ULONG (*QueryInterface)(IDirect3D* me);
|
|
|
|
|
* ULONG (*QueryInterface)(IDirect3D* me);
|
|
|
|
|
* HRESULT (*Initialize)(IDirect3D* me, REFIID a);
|
|
|
|
|
* HRESULT (*EnumDevices)(IDirect3D* me, LPD3DENUMDEVICESCALLBACK a, LPVOID b);
|
|
|
|
|
* HRESULT (*CreateLight)(IDirect3D* me, LPDIRECT3DLIGHT* a, IUnknown* b);
|
|
|
|
|
* HRESULT (*CreateMaterial)(IDirect3D* me, LPDIRECT3DMATERIAL* a, IUnknown* b);
|
|
|
|
|
* HRESULT (*CreateViewport)(IDirect3D* me, LPDIRECT3DVIEWPORT* a, IUnknown* b);
|
|
|
|
|
* HRESULT (*FindDevice)(IDirect3D* me, LPD3DFINDDEVICESEARCH a, LPD3DFINDDEVICERESULT b);
|
|
|
|
|
* };
|
|
|
|
|
*
|
2003-04-10 23:13:58 +02:00
|
|
|
|
* #ifdef COBJMACROS
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* // *** IUnknown methods *** //
|
|
|
|
|
* #define IDirect3D_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
|
|
|
|
|
* #define IDirect3D_AddRef(p) (p)->lpVtbl->AddRef(p)
|
|
|
|
|
* #define IDirect3D_Release(p) (p)->lpVtbl->Release(p)
|
|
|
|
|
* // *** IDirect3D methods *** //
|
|
|
|
|
* #define IDirect3D_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
|
|
|
|
|
* #define IDirect3D_EnumDevices(p,a,b) (p)->lpVtbl->EnumDevice(p,a,b)
|
|
|
|
|
* #define IDirect3D_CreateLight(p,a,b) (p)->lpVtbl->CreateLight(p,a,b)
|
|
|
|
|
* #define IDirect3D_CreateMaterial(p,a,b) (p)->lpVtbl->CreateMaterial(p,a,b)
|
|
|
|
|
* #define IDirect3D_CreateViewport(p,a,b) (p)->lpVtbl->CreateViewport(p,a,b)
|
|
|
|
|
* #define IDirect3D_FindDevice(p,a,b) (p)->lpVtbl->FindDevice(p,a,b)
|
|
|
|
|
* #endif
|
|
|
|
|
*
|
|
|
|
|
* Comments:
|
|
|
|
|
* - IDirect3D only contains a pointer to the IDirect3D virtual/jump table. This is the only thing
|
|
|
|
|
* the user needs to know to use the interface. Of course the structure we will define to
|
|
|
|
|
* implement this interface will have more fields but the first one will match this pointer.
|
|
|
|
|
* - The code generated by ICOM_DEFINE defines both the structure representing the interface and
|
2003-04-11 02:31:02 +02:00
|
|
|
|
* the structure for the jump table. ICOM_DEFINE uses the parent's Xxx_METHODS macro to
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* automatically repeat the prototypes of all the inherited methods and then uses IDirect3D_METHODS
|
|
|
|
|
* to define the IDirect3D methods.
|
|
|
|
|
* - Each method is declared as a pointer to function field in the jump table. The implementation
|
|
|
|
|
* will fill this jump table with appropriate values, probably using a static variable, and
|
|
|
|
|
* initialize the lpVtbl field to point to this variable.
|
|
|
|
|
* - The IDirect3D_Xxx macros then just derefence the lpVtbl pointer and use the function pointer
|
|
|
|
|
* corresponding to the macro name. This emulates the behavior of a virtual table and should be
|
|
|
|
|
* just as fast.
|
|
|
|
|
* - This C code should be quite compatible with the Windows headers both for code that uses COM
|
|
|
|
|
* interfaces and for code implementing a COM interface.
|
|
|
|
|
*
|
|
|
|
|
*
|
|
|
|
|
* And in C++ (with gcc's g++):
|
|
|
|
|
*
|
|
|
|
|
* typedef struct IDirect3D: public IUnknown {
|
2003-04-10 02:19:24 +02:00
|
|
|
|
* virtual HRESULT Initialize(REFIID a) = 0;
|
|
|
|
|
* virtual HRESULT EnumDevices(LPD3DENUMDEVICESCALLBACK a, LPVOID b) = 0;
|
|
|
|
|
* virtual HRESULT CreateLight(LPDIRECT3DLIGHT* a, IUnknown* b) = 0;
|
|
|
|
|
* virtual HRESULT CreateMaterial(LPDIRECT3DMATERIAL* a, IUnknown* b) = 0;
|
|
|
|
|
* virtual HRESULT CreateViewport(LPDIRECT3DVIEWPORT* a, IUnknown* b) = 0;
|
|
|
|
|
* virtual HRESULT FindDevice(LPD3DFINDDEVICESEARCH a, LPD3DFINDDEVICERESULT b) = 0;
|
2002-12-23 02:41:51 +01:00
|
|
|
|
* };
|
|
|
|
|
*
|
|
|
|
|
* Comments:
|
|
|
|
|
* - Of course in C++ we use inheritance so that we don't have to duplicate the method definitions.
|
|
|
|
|
* - Finally there is no IDirect3D_Xxx macro. These are not needed in C++ unless the CINTERFACE
|
|
|
|
|
* macro is defined in which case we would not be here.
|
|
|
|
|
*
|
|
|
|
|
*
|
|
|
|
|
* Implementing a COM interface.
|
|
|
|
|
*
|
|
|
|
|
* This continues the above example. This example assumes that the implementation is in C.
|
|
|
|
|
*
|
|
|
|
|
* typedef struct _IDirect3D {
|
|
|
|
|
* void* lpVtbl;
|
|
|
|
|
* // ...
|
|
|
|
|
*
|
|
|
|
|
* } _IDirect3D;
|
|
|
|
|
*
|
|
|
|
|
* static ICOM_VTABLE(IDirect3D) d3dvt;
|
|
|
|
|
*
|
|
|
|
|
* // implement the IDirect3D methods here
|
|
|
|
|
*
|
|
|
|
|
* int IDirect3D_QueryInterface(IDirect3D* me)
|
|
|
|
|
* {
|
|
|
|
|
* ICOM_THIS(IDirect3D,me);
|
|
|
|
|
* // ...
|
|
|
|
|
* }
|
|
|
|
|
*
|
|
|
|
|
* // ...
|
|
|
|
|
*
|
|
|
|
|
* static ICOM_VTABLE(IDirect3D) d3dvt = {
|
|
|
|
|
* ICOM_MSVTABLE_COMPAT_DummyRTTIVALUE
|
|
|
|
|
* IDirect3D_QueryInterface,
|
|
|
|
|
* IDirect3D_Add,
|
|
|
|
|
* IDirect3D_Add2,
|
|
|
|
|
* IDirect3D_Initialize,
|
|
|
|
|
* IDirect3D_SetWidth
|
|
|
|
|
* };
|
|
|
|
|
*
|
|
|
|
|
* Comments:
|
|
|
|
|
* - We first define what the interface really contains. This is th e_IDirect3D structure. The
|
|
|
|
|
* first field must of course be the virtual table pointer. Everything else is free.
|
|
|
|
|
* - Then we predeclare our static virtual table variable, we will need its address in some
|
|
|
|
|
* methods to initialize the virtual table pointer of the returned interface objects.
|
|
|
|
|
* - Then we implement the interface methods. To match what has been declared in the header file
|
|
|
|
|
* they must take a pointer to a IDirect3D structure and we must cast it to an _IDirect3D so that
|
|
|
|
|
* we can manipulate the fields. This is performed by the ICOM_THIS macro.
|
|
|
|
|
* - Finally we initialize the virtual table.
|
|
|
|
|
*/
|
|
|
|
|
|
2003-04-10 23:13:58 +02:00
|
|
|
|
#if defined(__cplusplus) && !defined(CINTERFACE)
|
2003-04-10 02:19:24 +02:00
|
|
|
|
|
2002-12-23 02:41:51 +01:00
|
|
|
|
/* C++ interface */
|
|
|
|
|
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define STDMETHOD(method) virtual HRESULT STDMETHODCALLTYPE method
|
|
|
|
|
#define STDMETHOD_(type,method) virtual type STDMETHODCALLTYPE method
|
|
|
|
|
#define STDMETHODV(method) virtual HRESULT STDMETHODVCALLTYPE method
|
|
|
|
|
#define STDMETHODV_(type,method) virtual type STDMETHODVCALLTYPE method
|
2002-12-23 02:41:51 +01:00
|
|
|
|
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define PURE = 0
|
|
|
|
|
#define THIS_
|
|
|
|
|
#define THIS void
|
|
|
|
|
|
|
|
|
|
#define interface struct
|
2003-04-12 02:09:14 +02:00
|
|
|
|
#ifdef ICOM_USE_COM_INTERFACE_ATTRIBUTE
|
|
|
|
|
#define DECLARE_INTERFACE(iface) interface __attribute__((com_interface)) iface
|
|
|
|
|
#else
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define DECLARE_INTERFACE(iface) interface iface
|
2003-04-12 02:09:14 +02:00
|
|
|
|
#endif
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define DECLARE_INTERFACE_(iface,ibase) interface iface : public ibase
|
|
|
|
|
|
|
|
|
|
#define BEGIN_INTERFACE
|
|
|
|
|
#define END_INTERFACE
|
|
|
|
|
|
2003-04-10 23:13:58 +02:00
|
|
|
|
#else /* __cplusplus && !CINTERFACE */
|
2003-04-10 02:19:24 +02:00
|
|
|
|
|
2002-12-23 02:41:51 +01:00
|
|
|
|
/* C interface */
|
|
|
|
|
|
2003-04-10 23:13:58 +02:00
|
|
|
|
#define COBJMACROS
|
|
|
|
|
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define STDMETHOD(method) HRESULT (STDMETHODCALLTYPE *method)
|
|
|
|
|
#define STDMETHOD_(type,method) type (STDMETHODCALLTYPE *method)
|
|
|
|
|
#define STDMETHODV(method) HRESULT (STDMETHODVCALLTYPE *method)
|
|
|
|
|
#define STDMETHODV_(type,method) type (STDMETHODVCALLTYPE *method)
|
2002-12-23 02:41:51 +01:00
|
|
|
|
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define PURE
|
|
|
|
|
#define THIS_ INTERFACE *This,
|
|
|
|
|
#define THIS INTERFACE *This
|
2002-12-23 02:41:51 +01:00
|
|
|
|
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define interface struct
|
|
|
|
|
|
|
|
|
|
#ifdef CONST_VTABLE
|
|
|
|
|
#undef CONST_VTBL
|
|
|
|
|
#define CONST_VTBL const
|
|
|
|
|
#define DECLARE_INTERFACE(iface) \
|
|
|
|
|
/*typedef*/ interface iface { const struct iface##Vtbl *lpVtbl; } /*iface*/; \
|
|
|
|
|
typedef const struct iface##Vtbl iface##Vtbl; \
|
|
|
|
|
const struct iface##Vtbl
|
|
|
|
|
#else
|
|
|
|
|
#undef CONST_VTBL
|
|
|
|
|
#define CONST_VTBL
|
|
|
|
|
#define DECLARE_INTERFACE(iface) \
|
|
|
|
|
/*typedef*/ interface iface { struct iface##Vtbl *lpVtbl; } /*iface*/; \
|
|
|
|
|
typedef struct iface##Vtbl iface##Vtbl; \
|
|
|
|
|
struct iface##Vtbl
|
|
|
|
|
#endif
|
|
|
|
|
#define DECLARE_INTERFACE_(iface,ibase) DECLARE_INTERFACE(iface)
|
|
|
|
|
|
|
|
|
|
#define BEGIN_INTERFACE
|
|
|
|
|
#define END_INTERFACE
|
|
|
|
|
|
2003-04-11 02:31:02 +02:00
|
|
|
|
#endif /* __cplusplus && !CINTERFACE */
|
|
|
|
|
|
2003-04-10 02:19:24 +02:00
|
|
|
|
/* Wine-specific macros */
|
2002-12-23 02:41:51 +01:00
|
|
|
|
|
2003-04-12 02:09:14 +02:00
|
|
|
|
#define ICOM_DEFINE(iface,ibase) DECLARE_INTERFACE_(iface,ibase) { iface##_METHODS };
|
2003-04-10 02:19:24 +02:00
|
|
|
|
#define ICOM_VTABLE(iface) iface##Vtbl
|
|
|
|
|
#define ICOM_VFIELD(iface) ICOM_VTABLE(iface)* lpVtbl
|
2003-04-12 02:09:14 +02:00
|
|
|
|
#define ICOM_THIS(impl,iface) impl* const This=(impl*)(iface)
|
2002-12-23 02:41:51 +01:00
|
|
|
|
#define ICOM_THIS_MULTI(impl,field,iface) impl* const This=(impl*)((char*)(iface) - offsetof(impl,field))
|
|
|
|
|
|
2003-04-10 23:13:58 +02:00
|
|
|
|
#include "objidl.h"
|
|
|
|
|
|
|
|
|
|
#ifndef RC_INVOKED
|
|
|
|
|
/* For compatibility only, at least for now */
|
|
|
|
|
#include <stdlib.h>
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifndef INITGUID
|
|
|
|
|
#include "cguid.h"
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C" {
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#ifndef NONAMELESSSTRUCT
|
|
|
|
|
#define LISet32(li, v) ((li).HighPart = (v) < 0 ? -1 : 0, (li).LowPart = (v))
|
|
|
|
|
#define ULISet32(li, v) ((li).HighPart = 0, (li).LowPart = (v))
|
|
|
|
|
#else
|
|
|
|
|
#define LISet32(li, v) ((li).s.HighPart = (v) < 0 ? -1 : 0, (li).s.LowPart = (v))
|
|
|
|
|
#define ULISet32(li, v) ((li).s.HighPart = 0, (li).s.LowPart = (v))
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* Standard API
|
|
|
|
|
*/
|
|
|
|
|
DWORD WINAPI CoBuildVersion(void);
|
|
|
|
|
|
|
|
|
|
typedef enum tagCOINIT
|
|
|
|
|
{
|
|
|
|
|
COINIT_APARTMENTTHREADED = 0x2, /* Apartment model */
|
|
|
|
|
COINIT_MULTITHREADED = 0x0, /* OLE calls objects on any thread */
|
|
|
|
|
COINIT_DISABLE_OLE1DDE = 0x4, /* Don't use DDE for Ole1 support */
|
|
|
|
|
COINIT_SPEED_OVER_MEMORY = 0x8 /* Trade memory for speed */
|
|
|
|
|
} COINIT;
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoInitialize(LPVOID lpReserved);
|
|
|
|
|
HRESULT WINAPI CoInitializeEx(LPVOID lpReserved, DWORD dwCoInit);
|
|
|
|
|
void WINAPI CoUninitialize(void);
|
|
|
|
|
DWORD WINAPI CoGetCurrentProcess(void);
|
|
|
|
|
|
|
|
|
|
HINSTANCE WINAPI CoLoadLibrary(LPOLESTR lpszLibName, BOOL bAutoFree);
|
|
|
|
|
void WINAPI CoFreeAllLibraries(void);
|
|
|
|
|
void WINAPI CoFreeLibrary(HINSTANCE hLibrary);
|
|
|
|
|
void WINAPI CoFreeUnusedLibraries(void);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoCreateInstance(REFCLSID rclsid, LPUNKNOWN pUnkOuter, DWORD dwClsContext, REFIID iid, LPVOID *ppv);
|
|
|
|
|
HRESULT WINAPI CoCreateInstanceEx(REFCLSID rclsid,
|
|
|
|
|
LPUNKNOWN pUnkOuter,
|
|
|
|
|
DWORD dwClsContext,
|
|
|
|
|
COSERVERINFO* pServerInfo,
|
|
|
|
|
ULONG cmq,
|
|
|
|
|
MULTI_QI* pResults);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoGetInstanceFromFile(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, DWORD grfMode, OLECHAR* pwszName, DWORD dwCount, MULTI_QI* pResults);
|
|
|
|
|
HRESULT WINAPI CoGetInstanceFromIStorage(COSERVERINFO* pServerInfo, CLSID* pClsid, IUnknown* punkOuter, DWORD dwClsCtx, IStorage* pstg, DWORD dwCount, MULTI_QI* pResults);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoGetMalloc(DWORD dwMemContext, LPMALLOC* lpMalloc);
|
|
|
|
|
LPVOID WINAPI CoTaskMemAlloc(ULONG size);
|
|
|
|
|
void WINAPI CoTaskMemFree(LPVOID ptr);
|
|
|
|
|
LPVOID WINAPI CoTaskMemRealloc(LPVOID ptr, ULONG size);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoRegisterMallocSpy(LPMALLOCSPY pMallocSpy);
|
|
|
|
|
HRESULT WINAPI CoRevokeMallocSpy(void);
|
|
|
|
|
|
|
|
|
|
/* class registration flags; passed to CoRegisterClassObject */
|
|
|
|
|
typedef enum tagREGCLS
|
|
|
|
|
{
|
|
|
|
|
REGCLS_SINGLEUSE = 0,
|
|
|
|
|
REGCLS_MULTIPLEUSE = 1,
|
|
|
|
|
REGCLS_MULTI_SEPARATE = 2,
|
|
|
|
|
REGCLS_SUSPENDED = 4
|
|
|
|
|
} REGCLS;
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoGetClassObject(REFCLSID rclsid, DWORD dwClsContext, COSERVERINFO *pServerInfo, REFIID iid, LPVOID *ppv);
|
|
|
|
|
HRESULT WINAPI CoRegisterClassObject(REFCLSID rclsid,LPUNKNOWN pUnk,DWORD dwClsContext,DWORD flags,LPDWORD lpdwRegister);
|
|
|
|
|
HRESULT WINAPI CoRevokeClassObject(DWORD dwRegister);
|
|
|
|
|
HRESULT WINAPI CoGetPSClsid(REFIID riid,CLSID *pclsid);
|
|
|
|
|
HRESULT WINAPI CoRegisterPSClsid(REFIID riid, REFCLSID rclsid);
|
|
|
|
|
HRESULT WINAPI CoSuspendClassObjects(void);
|
|
|
|
|
HRESULT WINAPI CoResumeClassObjects(void);
|
|
|
|
|
ULONG WINAPI CoAddRefServerProcess(void);
|
|
|
|
|
HRESULT WINAPI CoReleaseServerProcess(void);
|
|
|
|
|
|
|
|
|
|
/* marshalling */
|
|
|
|
|
HRESULT WINAPI CoCreateFreeThreadedMarshaler(LPUNKNOWN punkOuter, LPUNKNOWN* ppunkMarshal);
|
|
|
|
|
HRESULT WINAPI CoGetInterfaceAndReleaseStream(LPSTREAM pStm, REFIID iid, LPVOID* ppv);
|
|
|
|
|
HRESULT WINAPI CoGetMarshalSizeMax(ULONG* pulSize, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags);
|
|
|
|
|
HRESULT WINAPI CoGetStandardMarshal(REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags, LPMARSHAL* ppMarshal);
|
|
|
|
|
HRESULT WINAPI CoMarshalHresult(LPSTREAM pstm, HRESULT hresult);
|
|
|
|
|
HRESULT WINAPI CoMarshalInterface(LPSTREAM pStm, REFIID riid, LPUNKNOWN pUnk, DWORD dwDestContext, LPVOID pvDestContext, DWORD mshlflags);
|
|
|
|
|
HRESULT WINAPI CoMarshalInterThreadInterfaceInStream(REFIID riid, LPUNKNOWN pUnk, LPSTREAM* ppStm);
|
|
|
|
|
HRESULT WINAPI CoReleaseMarshalData(LPSTREAM pStm);
|
|
|
|
|
HRESULT WINAPI CoUnmarshalHresult(LPSTREAM pstm, HRESULT* phresult);
|
|
|
|
|
HRESULT WINAPI CoUnmarshalInterface(LPSTREAM pStm, REFIID riid, LPVOID* ppv);
|
|
|
|
|
HRESULT WINAPI CoLockObjectExternal(LPUNKNOWN pUnk, BOOL fLock, BOOL fLastUnlockReleases);
|
|
|
|
|
BOOL WINAPI CoIsHandlerConnected(LPUNKNOWN pUnk);
|
|
|
|
|
|
|
|
|
|
/* security */
|
|
|
|
|
HRESULT WINAPI CoInitializeSecurity(PSECURITY_DESCRIPTOR pSecDesc, LONG cAuthSvc, SOLE_AUTHENTICATION_SERVICE* asAuthSvc, void* pReserved1, DWORD dwAuthnLevel, DWORD dwImpLevel, void* pReserved2, DWORD dwCapabilities, void* pReserved3);
|
|
|
|
|
HRESULT WINAPI CoGetCallContext(REFIID riid, void** ppInterface);
|
|
|
|
|
HRESULT WINAPI CoQueryAuthenticationServices(DWORD* pcAuthSvc, SOLE_AUTHENTICATION_SERVICE** asAuthSvc);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoQueryProxyBlanket(IUnknown* pProxy, DWORD* pwAuthnSvc, DWORD* pAuthzSvc, OLECHAR** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTH_IDENTITY_HANDLE* pAuthInfo, DWORD* pCapabilites);
|
|
|
|
|
HRESULT WINAPI CoSetProxyBlanket(IUnknown* pProxy, DWORD dwAuthnSvc, DWORD dwAuthzSvc, OLECHAR* pServerPrincName, DWORD dwAuthnLevel, DWORD dwImpLevel, RPC_AUTH_IDENTITY_HANDLE pAuthInfo, DWORD dwCapabilities);
|
|
|
|
|
HRESULT WINAPI CoCopyProxy(IUnknown* pProxy, IUnknown** ppCopy);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoImpersonateClient(void);
|
|
|
|
|
HRESULT WINAPI CoQueryClientBlanket(DWORD* pAuthnSvc, DWORD* pAuthzSvc, OLECHAR16** pServerPrincName, DWORD* pAuthnLevel, DWORD* pImpLevel, RPC_AUTHZ_HANDLE* pPrivs, DWORD* pCapabilities);
|
|
|
|
|
HRESULT WINAPI CoRevertToSelf(void);
|
|
|
|
|
|
|
|
|
|
/* misc */
|
|
|
|
|
HRESULT WINAPI CoGetTreatAsClass(REFCLSID clsidOld, LPCLSID pClsidNew);
|
|
|
|
|
HRESULT WINAPI CoTreatAsClass(REFCLSID clsidOld, REFCLSID clsidNew);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CoCreateGuid(GUID* pguid);
|
|
|
|
|
BOOL WINAPI CoIsOle1Class(REFCLSID rclsid);
|
|
|
|
|
|
|
|
|
|
BOOL WINAPI CoDosDateTimeToFileTime(WORD nDosDate, WORD nDosTime, FILETIME* lpFileTime);
|
|
|
|
|
BOOL WINAPI CoFileTimeToDosDateTime(FILETIME* lpFileTime, WORD* lpDosDate, WORD* lpDosTime);
|
|
|
|
|
HRESULT WINAPI CoFileTimeNow(FILETIME* lpFileTime);
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* GUID API
|
|
|
|
|
*/
|
|
|
|
|
HRESULT WINAPI StringFromCLSID16(REFCLSID id, LPOLESTR16*);
|
|
|
|
|
HRESULT WINAPI StringFromCLSID(REFCLSID id, LPOLESTR*);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CLSIDFromString16(LPCOLESTR16, CLSID *);
|
|
|
|
|
HRESULT WINAPI CLSIDFromString(LPCOLESTR, CLSID *);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CLSIDFromProgID16(LPCOLESTR16 progid, LPCLSID riid);
|
|
|
|
|
HRESULT WINAPI CLSIDFromProgID(LPCOLESTR progid, LPCLSID riid);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI ProgIDFromCLSID(REFCLSID clsid, LPOLESTR *lplpszProgID);
|
|
|
|
|
|
|
|
|
|
INT WINAPI StringFromGUID2(REFGUID id, LPOLESTR str, INT cmax);
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* COM Server dll - exports
|
|
|
|
|
*/
|
|
|
|
|
HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID * ppv);
|
|
|
|
|
HRESULT WINAPI DllCanUnloadNow(void);
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* Data Object
|
|
|
|
|
*/
|
|
|
|
|
HRESULT WINAPI CreateDataAdviseHolder(LPDATAADVISEHOLDER* ppDAHolder);
|
|
|
|
|
HRESULT WINAPI CreateDataCache(LPUNKNOWN pUnkOuter, REFCLSID rclsid, REFIID iid, LPVOID* ppv);
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* Moniker API
|
|
|
|
|
*/
|
|
|
|
|
HRESULT WINAPI GetClassFile(LPCOLESTR filePathName,CLSID *pclsid);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CreateBindCtx16(DWORD reserved, LPBC* ppbc);
|
|
|
|
|
HRESULT WINAPI CreateBindCtx(DWORD reserved, LPBC* ppbc);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CreateFileMoniker16(LPCOLESTR16 lpszPathName, LPMONIKER* ppmk);
|
|
|
|
|
HRESULT WINAPI CreateFileMoniker(LPCOLESTR lpszPathName, LPMONIKER* ppmk);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CreateItemMoniker16(LPCOLESTR16 lpszDelim, LPCOLESTR lpszItem, LPMONIKER* ppmk);
|
|
|
|
|
HRESULT WINAPI CreateItemMoniker(LPCOLESTR lpszDelim, LPCOLESTR lpszItem, LPMONIKER* ppmk);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CreateAntiMoniker(LPMONIKER * ppmk);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CreateGenericComposite(LPMONIKER pmkFirst, LPMONIKER pmkRest, LPMONIKER* ppmkComposite);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI BindMoniker(LPMONIKER pmk, DWORD grfOpt, REFIID iidResult, LPVOID* ppvResult);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CreateClassMoniker(REFCLSID rclsid, LPMONIKER* ppmk);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI CreatePointerMoniker(LPUNKNOWN punk, LPMONIKER* ppmk);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI MonikerCommonPrefixWith(IMoniker* pmkThis,IMoniker* pmkOther,IMoniker** ppmkCommon);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI GetRunningObjectTable(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot);
|
|
|
|
|
HRESULT WINAPI GetRunningObjectTable16(DWORD reserved, LPRUNNINGOBJECTTABLE *pprot);
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
* Storage API
|
|
|
|
|
*/
|
|
|
|
|
#define STGM_DIRECT 0x00000000
|
|
|
|
|
#define STGM_TRANSACTED 0x00010000
|
|
|
|
|
#define STGM_SIMPLE 0x08000000
|
|
|
|
|
#define STGM_READ 0x00000000
|
|
|
|
|
#define STGM_WRITE 0x00000001
|
|
|
|
|
#define STGM_READWRITE 0x00000002
|
|
|
|
|
#define STGM_SHARE_DENY_NONE 0x00000040
|
|
|
|
|
#define STGM_SHARE_DENY_READ 0x00000030
|
|
|
|
|
#define STGM_SHARE_DENY_WRITE 0x00000020
|
|
|
|
|
#define STGM_SHARE_EXCLUSIVE 0x00000010
|
|
|
|
|
#define STGM_PRIORITY 0x00040000
|
|
|
|
|
#define STGM_DELETEONRELEASE 0x04000000
|
|
|
|
|
#define STGM_CREATE 0x00001000
|
|
|
|
|
#define STGM_CONVERT 0x00020000
|
|
|
|
|
#define STGM_FAILIFTHERE 0x00000000
|
|
|
|
|
#define STGM_NOSCRATCH 0x00100000
|
|
|
|
|
#define STGM_NOSNAPSHOT 0x00200000
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI StgCreateDocFile16(LPCOLESTR16 pwcsName,DWORD grfMode,DWORD reserved,IStorage16 **ppstgOpen);
|
|
|
|
|
HRESULT WINAPI StgCreateDocfile(LPCOLESTR pwcsName,DWORD grfMode,DWORD reserved,IStorage **ppstgOpen);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI StgIsStorageFile16(LPCOLESTR16 fn);
|
|
|
|
|
HRESULT WINAPI StgIsStorageFile(LPCOLESTR fn);
|
|
|
|
|
HRESULT WINAPI StgIsStorageILockBytes(ILockBytes *plkbyt);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI StgOpenStorage16(const OLECHAR16* pwcsName,IStorage16* pstgPriority,DWORD grfMode,SNB16 snbExclude,DWORD reserved,IStorage16**ppstgOpen);
|
|
|
|
|
HRESULT WINAPI StgOpenStorage(const OLECHAR* pwcsName,IStorage* pstgPriority,DWORD grfMode,SNB snbExclude,DWORD reserved,IStorage**ppstgOpen);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI WriteClassStg(IStorage* pStg, REFCLSID rclsid);
|
|
|
|
|
HRESULT WINAPI ReadClassStg(IStorage *pstg,CLSID *pclsid);
|
|
|
|
|
|
|
|
|
|
HRESULT WINAPI StgCreateDocfileOnILockBytes(ILockBytes *plkbyt,DWORD grfMode, DWORD reserved, IStorage** ppstgOpen);
|
|
|
|
|
HRESULT WINAPI StgOpenStorageOnILockBytes(ILockBytes *plkbyt, IStorage *pstgPriority, DWORD grfMode, SNB snbExclude, DWORD reserved, IStorage **ppstgOpen);
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
}
|
|
|
|
|
#endif
|
2002-12-23 02:41:51 +01:00
|
|
|
|
|
|
|
|
|
|
2003-01-04 01:52:18 +01:00
|
|
|
|
#ifndef __WINESRC__
|
2003-04-10 02:19:24 +02:00
|
|
|
|
|
1999-06-05 17:23:20 +02:00
|
|
|
|
#define FARSTRUCT
|
|
|
|
|
#define HUGEP
|
|
|
|
|
|
1999-03-10 19:03:53 +01:00
|
|
|
|
#define WINOLEAPI STDAPI
|
|
|
|
|
#define WINOLEAPI_(type) STDAPI_(type)
|
|
|
|
|
|
2003-01-04 01:52:18 +01:00
|
|
|
|
#endif /* __WINESRC__ */
|
1998-12-18 17:00:03 +01:00
|
|
|
|
|
2002-12-05 23:11:43 +01:00
|
|
|
|
#endif /* _OBJBASE_H_ */
|