2 * Copyright (C) 1998-1999 Francois Gouget
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.
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.
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
25 /*****************************************************************************
26 * Macros to define a COM interface
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.
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.
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.
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.
51 * Let's take Direct3D as an example:
53 * #define INTERFACE IDirect3D
54 * DECLARE_INTERFACE_(IDirect3D,IUnknown)
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;
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)
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
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
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.
110 * typedef struct IDirect3DVtbl IDirect3DVtbl;
112 * IDirect3DVtbl* lpVtbl;
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);
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)
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
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.
156 * And in C++ (with gcc's g++):
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;
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.
173 * Implementing a COM interface.
175 * This continues the above example. This example assumes that the implementation is in C.
177 * typedef struct IDirect3DImpl {
183 * static IDirect3DVtbl d3dvt;
185 * // implement the IDirect3D methods here
187 * int IDirect3D_QueryInterface(IDirect3D* me)
189 * IDirect3DImpl *This = (IDirect3DImpl *)me;
195 * static IDirect3DVtbl d3dvt = {
196 * IDirect3D_QueryInterface,
199 * IDirect3D_Initialize,
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.
214 #if defined(__cplusplus) && !defined(CINTERFACE)
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
227 #define interface struct
228 #define DECLARE_INTERFACE(iface) interface DECLSPEC_NOVTABLE iface
229 #define DECLARE_INTERFACE_(iface,ibase) interface DECLSPEC_NOVTABLE iface : public ibase
230 #define DECLARE_INTERFACE_IID_(iface, ibase, iid) interface DECLSPEC_UUID(iid) DECLSPEC_NOVTABLE iface : public ibase
232 #define BEGIN_INTERFACE
233 #define END_INTERFACE
235 #else /* __cplusplus && !CINTERFACE */
239 #define STDMETHOD(method) HRESULT (STDMETHODCALLTYPE *method)
240 #define STDMETHOD_(type,method) type (STDMETHODCALLTYPE *method)
241 #define STDMETHODV(method) HRESULT (STDMETHODVCALLTYPE *method)
242 #define STDMETHODV_(type,method) type (STDMETHODVCALLTYPE *method)
245 #define THIS_ INTERFACE *This,
246 #define THIS INTERFACE *This
248 #define interface struct
256 #define CONST_VTBL const
257 #define DECLARE_INTERFACE(iface) \
258 typedef interface iface { const struct iface##Vtbl *lpVtbl; } iface; \
259 typedef struct iface##Vtbl iface##Vtbl; \
264 #define DECLARE_INTERFACE(iface) \
265 typedef interface iface { struct iface##Vtbl *lpVtbl; } iface; \
266 typedef struct iface##Vtbl iface##Vtbl; \
269 #define DECLARE_INTERFACE_(iface,ibase) DECLARE_INTERFACE(iface)
270 #define DECLARE_INTERFACE_IID_(iface, ibase, iid) DECLARE_INTERFACE_(iface, ibase)
272 #define BEGIN_INTERFACE
273 #define END_INTERFACE
275 #endif /* __cplusplus && !CINTERFACE */
277 #ifndef __IRpcStubBuffer_FWD_DEFINED__
278 #define __IRpcStubBuffer_FWD_DEFINED__
279 typedef interface IRpcStubBuffer IRpcStubBuffer
;
281 #ifndef __IRpcChannelBuffer_FWD_DEFINED__
282 #define __IRpcChannelBuffer_FWD_DEFINED__
283 typedef interface IRpcChannelBuffer IRpcChannelBuffer
;
287 /* For compatibility only, at least for now */
304 #ifndef NONAMELESSSTRUCT
305 #define LISet32(li, v) ((li).HighPart = (v) < 0 ? -1 : 0, (li).LowPart = (v))
306 #define ULISet32(li, v) ((li).HighPart = 0, (li).LowPart = (v))
308 #define LISet32(li, v) ((li).u.HighPart = (v) < 0 ? -1 : 0, (li).u.LowPart = (v))
309 #define ULISet32(li, v) ((li).u.HighPart = 0, (li).u.LowPart = (v))
312 /*****************************************************************************
315 DWORD WINAPI
CoBuildVersion(void);
317 typedef enum tagCOINIT
319 COINIT_APARTMENTTHREADED
= 0x2, /* Apartment model */
320 COINIT_MULTITHREADED
= 0x0, /* OLE calls objects on any thread */
321 COINIT_DISABLE_OLE1DDE
= 0x4, /* Don't use DDE for Ole1 support */
322 COINIT_SPEED_OVER_MEMORY
= 0x8 /* Trade memory for speed */
325 _Check_return_ HRESULT WINAPI
CoInitialize(_In_opt_ LPVOID lpReserved
);
331 _In_opt_ LPVOID lpReserved
,
332 _In_ DWORD dwCoInit
);
334 void WINAPI
CoUninitialize(void);
335 DWORD WINAPI
CoGetCurrentProcess(void);
337 HINSTANCE WINAPI
CoLoadLibrary(_In_ LPOLESTR lpszLibName
, _In_ BOOL bAutoFree
);
338 void WINAPI
CoFreeAllLibraries(void);
339 void WINAPI
CoFreeLibrary(_In_ HINSTANCE hLibrary
);
340 void WINAPI
CoFreeUnusedLibraries(void);
344 CoFreeUnusedLibrariesEx(
345 _In_ DWORD dwUnloadDelay
,
346 _In_ DWORD dwReserved
);
352 _In_ REFCLSID rclsid
,
353 _In_opt_ LPUNKNOWN pUnkOuter
,
354 _In_ DWORD dwClsContext
,
356 _Outptr_
_At_(*ppv
, _Post_readable_size_(_Inexpressible_(varies
))) LPVOID
*ppv
);
362 _In_ REFCLSID rclsid
,
363 _In_opt_ LPUNKNOWN pUnkOuter
,
364 _In_ DWORD dwClsContext
,
365 _In_opt_ COSERVERINFO
*pServerInfo
,
367 _Inout_updates_(cmq
) MULTI_QI
*pResults
);
372 CoGetInstanceFromFile(
373 _In_opt_ COSERVERINFO
*pServerInfo
,
374 _In_opt_ CLSID
*pClsid
,
375 _In_opt_ IUnknown
*punkOuter
,
378 _In_ _Null_terminated_ OLECHAR
*pwszName
,
380 _Inout_updates_(dwCount
) MULTI_QI
*pResults
);
385 CoGetInstanceFromIStorage(
386 _In_opt_ COSERVERINFO
*pServerInfo
,
387 _In_opt_ CLSID
*pClsid
,
388 _In_opt_ IUnknown
*punkOuter
,
392 _Inout_updates_(dwCount
) MULTI_QI
*pResults
);
398 _In_ DWORD dwMemContext
,
399 _Outptr_ LPMALLOC
*lpMalloc
);
402 _Post_writable_byte_size_(size
)
403 __drv_allocatesMem(Mem
)
407 CoTaskMemAlloc(_In_ ULONG size
) __WINE_ALLOC_SIZE(1);
412 _In_opt_
__drv_freesMem(Mem
) _Post_invalid_ LPVOID ptr
);
415 _Post_writable_byte_size_(size
)
416 _When_(size
> 0, __drv_allocatesMem(Mem
) _Check_return_
)
420 _In_opt_
__drv_freesMem(Mem
) _Post_invalid_ LPVOID ptr
,
423 HRESULT WINAPI
CoRegisterMallocSpy(_In_ LPMALLOCSPY pMallocSpy
);
424 HRESULT WINAPI
CoRevokeMallocSpy(void);
426 _Check_return_ HRESULT WINAPI
CoGetContextToken(_Out_ ULONG_PTR
*token
);
428 /* class registration flags; passed to CoRegisterClassObject */
429 typedef enum tagREGCLS
431 REGCLS_SINGLEUSE
= 0,
432 REGCLS_MULTIPLEUSE
= 1,
433 REGCLS_MULTI_SEPARATE
= 2,
434 REGCLS_SUSPENDED
= 4,
442 _In_ REFCLSID rclsid
,
443 _In_ DWORD dwClsContext
,
444 _In_opt_ COSERVERINFO
*pServerInfo
,
446 _Outptr_ LPVOID
*ppv
);
451 CoRegisterClassObject(
452 _In_ REFCLSID rclsid
,
454 _In_ DWORD dwClsContext
,
456 _Out_ LPDWORD lpdwRegister
);
462 _In_ DWORD dwRegister
);
469 _Out_ CLSID
*pclsid
);
476 _In_ REFCLSID rclsid
);
478 _Check_return_ HRESULT WINAPI
CoRegisterSurrogate(_In_ LPSURROGATE pSurrogate
);
479 _Check_return_ HRESULT WINAPI
CoSuspendClassObjects(void);
480 _Check_return_ HRESULT WINAPI
CoResumeClassObjects(void);
481 ULONG WINAPI
CoAddRefServerProcess(void);
482 ULONG WINAPI
CoReleaseServerProcess(void);
489 CoCreateFreeThreadedMarshaler(
490 _In_opt_ LPUNKNOWN punkOuter
,
491 _Outptr_ LPUNKNOWN
*ppunkMarshal
);
496 CoGetInterfaceAndReleaseStream(
499 _Outptr_ LPVOID
*ppv
);
505 _Out_ ULONG
*pulSize
,
508 _In_ DWORD dwDestContext
,
509 _In_opt_ LPVOID pvDestContext
,
510 _In_ DWORD mshlflags
);
515 CoGetStandardMarshal(
518 _In_ DWORD dwDestContext
,
519 _In_opt_ LPVOID pvDestContext
,
520 _In_ DWORD mshlflags
,
521 _Outptr_ LPMARSHAL
*ppMarshal
);
523 HRESULT WINAPI
CoMarshalHresult(_In_ LPSTREAM pstm
, _In_ HRESULT hresult
);
532 _In_ DWORD dwDestContext
,
533 _In_opt_ LPVOID pvDestContext
,
534 _In_ DWORD mshlflags
);
539 CoMarshalInterThreadInterfaceInStream(
542 _Outptr_ LPSTREAM
*ppStm
);
544 _Check_return_ HRESULT WINAPI
CoReleaseMarshalData(_In_ LPSTREAM pStm
);
550 _In_ LPUNKNOWN lpUnk
,
551 _In_ DWORD reserved
);
553 HRESULT WINAPI
CoUnmarshalHresult(_In_ LPSTREAM pstm
, _Out_ HRESULT
*phresult
);
558 CoUnmarshalInterface(
561 _Outptr_ LPVOID
*ppv
);
566 CoLockObjectExternal(
569 _In_ BOOL fLastUnlockReleases
);
571 BOOL WINAPI
CoIsHandlerConnected(_In_ LPUNKNOWN pUnk
);
578 CoInitializeSecurity(
579 _In_opt_ PSECURITY_DESCRIPTOR pSecDesc
,
581 _In_reads_opt_(cAuthSvc
) SOLE_AUTHENTICATION_SERVICE
*asAuthSvc
,
582 _In_opt_
void *pReserved1
,
583 _In_ DWORD dwAuthnLevel
,
584 _In_ DWORD dwImpLevel
,
585 _In_opt_
void *pReserved2
,
586 _In_ DWORD dwCapabilities
,
587 _In_opt_
void *pReserved3
);
594 _Outptr_
void **ppInterface
);
600 _In_opt_ IUnknown
*pContext
,
601 _Outptr_ IUnknown
**ppOldContext
);
606 CoQueryAuthenticationServices(
607 _Out_ DWORD
*pcAuthSvc
,
608 _Outptr_result_buffer_(*pcAuthSvc
) SOLE_AUTHENTICATION_SERVICE
**asAuthSvc
);
614 _In_ IUnknown
*pProxy
,
615 _Out_opt_ DWORD
*pwAuthnSvc
,
616 _Out_opt_ DWORD
*pAuthzSvc
,
617 _Outptr_opt_ OLECHAR
**pServerPrincName
,
618 _Out_opt_ DWORD
*pAuthnLevel
,
619 _Out_opt_ DWORD
*pImpLevel
,
620 _Out_opt_ RPC_AUTH_IDENTITY_HANDLE
*pAuthInfo
,
621 _Out_opt_ DWORD
*pCapabilities
);
627 _In_ IUnknown
*pProxy
,
628 _In_ DWORD dwAuthnSvc
,
629 _In_ DWORD dwAuthzSvc
,
630 _In_opt_ OLECHAR
*pServerPrincName
,
631 _In_ DWORD dwAuthnLevel
,
632 _In_ DWORD dwImpLevel
,
633 _In_opt_ RPC_AUTH_IDENTITY_HANDLE pAuthInfo
,
634 _In_ DWORD dwCapabilities
);
639 _In_ IUnknown
*pProxy
,
640 _Outptr_ IUnknown
**ppCopy
);
642 _Check_return_ HRESULT WINAPI
CoImpersonateClient(void);
647 CoQueryClientBlanket(
648 _Out_opt_ DWORD
*pAuthnSvc
,
649 _Out_opt_ DWORD
*pAuthzSvc
,
650 _Outptr_opt_ OLECHAR
**pServerPrincName
,
651 _Out_opt_ DWORD
*pAuthnLevel
,
652 _Out_opt_ DWORD
*pImpLevel
,
653 _Outptr_opt_ RPC_AUTHZ_HANDLE
*pPrivs
,
654 _Inout_opt_ DWORD
*pCapabilities
);
656 _Check_return_ HRESULT WINAPI
CoRevertToSelf(void);
664 _In_ REFCLSID clsidOld
,
665 _Out_ LPCLSID pClsidNew
);
671 _In_ REFCLSID clsidOld
,
672 _In_ REFCLSID clsidNew
);
676 CoAllowSetForegroundWindow(
678 _In_opt_ LPVOID lpvReserved
);
685 _Outptr_ LPVOID
*ppv
);
687 _Check_return_ HRESULT WINAPI
CoCreateGuid(_Out_ GUID
*pguid
);
688 BOOL WINAPI
CoIsOle1Class(_In_ REFCLSID rclsid
);
692 CoDosDateTimeToFileTime(
695 _Out_ FILETIME
*lpFileTime
);
699 CoFileTimeToDosDateTime(
700 _In_ FILETIME
*lpFileTime
,
701 _Out_ WORD
*lpDosDate
,
702 _Out_ WORD
*lpDosTime
);
704 HRESULT WINAPI
CoFileTimeNow(_Out_ FILETIME
*lpFileTime
);
709 CoRegisterMessageFilter(
710 _In_opt_ LPMESSAGEFILTER lpMessageFilter
,
711 _Outptr_opt_result_maybenull_ LPMESSAGEFILTER
*lplpMessageFilter
);
715 CoRegisterChannelHook(
716 _In_ REFGUID ExtensionGuid
,
717 _In_ IChannelHook
*pChannelHook
);
719 typedef enum tagCOWAIT_FLAGS
721 COWAIT_WAITALL
= 0x00000001,
722 COWAIT_ALERTABLE
= 0x00000002
728 CoWaitForMultipleHandles(
730 _In_ DWORD dwTimeout
,
732 _In_reads_(cHandles
) LPHANDLE pHandles
,
733 _Out_ LPDWORD lpdwindex
);
735 /*****************************************************************************
757 _In_ LPCOLESTR progid
,
765 _Outptr_ LPOLESTR
*lplpszProgID
);
772 _Out_writes_to_(cmax
, return) LPOLESTR str
,
775 /*****************************************************************************
776 * COM Server dll - exports
783 _In_ REFCLSID rclsid
,
785 _Outptr_ LPVOID
*ppv
) DECLSPEC_HIDDEN
;
787 HRESULT WINAPI
DllCanUnloadNow(void) DECLSPEC_HIDDEN
;
789 /* shouldn't be here, but is nice for type checking */
791 HRESULT WINAPI
DllRegisterServer(void) DECLSPEC_HIDDEN
;
792 HRESULT WINAPI
DllUnregisterServer(void) DECLSPEC_HIDDEN
;
796 /*****************************************************************************
802 CreateDataAdviseHolder(
803 _Outptr_ LPDATAADVISEHOLDER
*ppDAHolder
);
808 _In_opt_ LPUNKNOWN pUnkOuter
,
809 _In_ REFCLSID rclsid
,
813 /*****************************************************************************
823 _In_ REFIID iidResult
,
824 _Outptr_ LPVOID
*ppvResult
);
830 _In_ LPCWSTR pszName
,
831 _In_opt_ BIND_OPTS
*pBindOptions
,
833 _Outptr_
void **ppv
);
835 _Check_return_ HRESULT WINAPI
CreateAntiMoniker(_Outptr_ LPMONIKER
*ppmk
);
842 _Outptr_ LPBC
*ppbc
);
848 _In_ REFCLSID rclsid
,
849 _Outptr_ LPMONIKER
*ppmk
);
855 _In_ LPCOLESTR lpszPathName
,
856 _Outptr_ LPMONIKER
*ppmk
);
861 CreateGenericComposite(
862 _In_opt_ LPMONIKER pmkFirst
,
863 _In_opt_ LPMONIKER pmkRest
,
864 _Outptr_ LPMONIKER
*ppmkComposite
);
870 _In_ LPCOLESTR lpszDelim
,
871 _In_ LPCOLESTR lpszItem
,
872 _Outptr_ LPMONIKER
*ppmk
);
878 _In_opt_ LPUNKNOWN punk
,
879 _Outptr_ LPMONIKER
*ppmk
);
884 CreatePointerMoniker(
885 _In_opt_ LPUNKNOWN punk
,
886 _Outptr_ LPMONIKER
*ppmk
);
892 _In_ LPCOLESTR filePathName
,
893 _Out_ CLSID
*pclsid
);
898 GetRunningObjectTable(
900 _Outptr_ LPRUNNINGOBJECTTABLE
*pprot
);
907 _In_ LPCOLESTR szUserName
,
908 _Out_ ULONG
*pchEaten
,
909 _Outptr_ LPMONIKER
*ppmk
);
914 MonikerCommonPrefixWith(
915 _In_ IMoniker
*pmkThis
,
916 _In_ IMoniker
*pmkOther
,
917 _Outptr_ IMoniker
**ppmkCommon
);
922 MonikerRelativePathTo(
923 _In_ LPMONIKER pmkSrc
,
924 _In_ LPMONIKER pmkDest
,
925 _Outptr_ LPMONIKER
*ppmkRelPath
,
926 _In_ BOOL dwReserved
);
928 /*****************************************************************************
931 #define STGM_DIRECT 0x00000000
932 #define STGM_TRANSACTED 0x00010000
933 #define STGM_SIMPLE 0x08000000
934 #define STGM_READ 0x00000000
935 #define STGM_WRITE 0x00000001
936 #define STGM_READWRITE 0x00000002
937 #define STGM_SHARE_DENY_NONE 0x00000040
938 #define STGM_SHARE_DENY_READ 0x00000030
939 #define STGM_SHARE_DENY_WRITE 0x00000020
940 #define STGM_SHARE_EXCLUSIVE 0x00000010
941 #define STGM_PRIORITY 0x00040000
942 #define STGM_DELETEONRELEASE 0x04000000
943 #define STGM_CREATE 0x00001000
944 #define STGM_CONVERT 0x00020000
945 #define STGM_FAILIFTHERE 0x00000000
946 #define STGM_NOSCRATCH 0x00100000
947 #define STGM_NOSNAPSHOT 0x00200000
948 #define STGM_DIRECT_SWMR 0x00400000
950 #define STGFMT_STORAGE 0
951 #define STGFMT_FILE 3
953 #define STGFMT_DOCFILE 5
955 typedef struct tagSTGOPTIONS
960 const WCHAR
* pwcsTemplateFile
;
968 _Outptr_ LPOLESTR
*lplpsz
);
974 _In_opt_ _Null_terminated_ LPCOLESTR pwcsName
,
976 _Reserved_ DWORD reserved
,
977 _Outptr_ IStorage
**ppstgOpen
);
983 _In_opt_ _Null_terminated_
const WCHAR
*,
987 _Inout_opt_ STGOPTIONS
*,
996 _In_ _Null_terminated_ LPCOLESTR fn
);
1001 StgIsStorageILockBytes(
1002 _In_ ILockBytes
*plkbyt
);
1008 _In_opt_ _Null_terminated_
const OLECHAR
*pwcsName
,
1009 _In_opt_ IStorage
*pstgPriority
,
1011 _In_opt_z_ SNB snbExclude
,
1012 _In_ DWORD reserved
,
1013 _Outptr_ IStorage
**ppstgOpen
);
1019 _In_ _Null_terminated_
const WCHAR
*pwcwName
,
1022 _In_ DWORD grfAttrs
,
1023 _Inout_opt_ STGOPTIONS
*pStgOptions
,
1024 _In_opt_
void *reserved
,
1026 _Outptr_
void **ppObjectOpen
);
1031 StgCreateDocfileOnILockBytes(
1032 _In_ ILockBytes
*plkbyt
,
1034 _In_ DWORD reserved
,
1035 _Outptr_ IStorage
**ppstgOpen
);
1040 StgOpenStorageOnILockBytes(
1041 _In_ ILockBytes
*plkbyt
,
1042 _In_opt_ IStorage
*pstgPriority
,
1044 _In_opt_z_ SNB snbExclude
,
1045 _Reserved_ DWORD reserved
,
1046 _Outptr_ IStorage
**ppstgOpen
);
1052 _In_ _Null_terminated_ OLECHAR
const *lpszName
,
1053 _In_opt_ FILETIME
const *pctime
,
1054 _In_opt_ FILETIME
const *patime
,
1055 _In_opt_ FILETIME
const *pmtime
);
1062 # include <urlmon.h>
1064 #include <propidl.h>
1071 #define WINOLEAPI STDAPI
1072 #define WINOLEAPI_(type) STDAPI_(type)
1074 #endif /* __WINESRC__ */
1076 #endif /* _OBJBASE_H_ */