25#include <winpr/platform.h>
26#include <winpr/winpr.h>
27#include <winpr/wtypes.h>
28#include <winpr/error.h>
80#define WINPR_COM_CALL __stdcall
86#if defined(__cplusplus) && !defined(WINPR_COM_CINTERFACE)
93#define WINPR_COM_CAST(t, val) reinterpret_cast<t>(val)
95#define WINPR_COM_CAST(t, val) ((t)(val))
101#define WINPR_COM_CXX_INTERFACE(name) \
107 name(const name&) = delete; \
108 name(name&&) = delete; \
109 name& operator=(const name&) = delete; \
110 name& operator=(name&&) = delete;
123 (
wIUnknown* This,
const IID* riid,
void** ppvObject);
136 virtual HRESULT
WINPR_COM_CALL QueryInterface(
const IID* riid,
void** ppvObject) = 0;
158#define WINPR_COM_DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) \
159 static const GUID name = { l, w1, w2, { b1, b2, b3, b4, b5, b6, b7, b8 } }
163 0x00, 0x00, 0x00, 0x46);
168 return memcmp(a, b,
sizeof(*a)) == 0;
173#define WINPR_COM_GUID_FMT \
174 "{%08" PRIX32 "-%04" PRIX16 "-%04" PRIX16 "-%02" PRIX8 "%02" PRIX8 "-%02" PRIX8 "%02" PRIX8 \
175 "%02" PRIX8 "%02" PRIX8 "%02" PRIX8 "%02" PRIX8 "}"
176#define WINPR_COM_GUID_ARGS(g) \
177 (UINT32)(g)->Data1, (UINT16)(g)->Data2, (UINT16)(g)->Data3, (g)->Data4[0], (g)->Data4[1], \
178 (g)->Data4[2], (g)->Data4[3], (g)->Data4[4], (g)->Data4[5], (g)->Data4[6], (g)->Data4[7]
184#define WINPR_COM_QUERY_INTERFACE(obj, iid, ppv) \
185 ((obj)->QueryInterface((iid), WINPR_COM_CAST(void**, ppv)))
186#define WINPR_COM_ADDREF(obj) ((obj)->AddRef())
187#define WINPR_COM_RELEASE(obj) ((obj)->Release())
189#define WINPR_COM_IUNKNOWN_VTBL(obj) WINPR_COM_CAST(const wIUnknownVtbl*, (obj)->lpVtbl)
191#define WINPR_COM_QUERY_INTERFACE(obj, iid, ppv) \
192 (WINPR_COM_IUNKNOWN_VTBL(obj)->QueryInterface(WINPR_COM_CAST(wIUnknown*, obj), (iid), \
193 WINPR_COM_CAST(void**, ppv)))
194#define WINPR_COM_ADDREF(obj) \
195 (WINPR_COM_IUNKNOWN_VTBL(obj)->AddRef(WINPR_COM_CAST(wIUnknown*, obj)))
196#define WINPR_COM_RELEASE(obj) \
197 (WINPR_COM_IUNKNOWN_VTBL(obj)->Release(WINPR_COM_CAST(wIUnknown*, obj)))
235 volatile LONG refCount;
236 const char* className;
264#define WINPR_COM_REFCOUNT_THUNKS(prefix) \
265 static ULONG WINPR_COM_CALL prefix##_AddRef(wIUnknown* This) \
267 return winpr_com_base_add_ref(WINPR_COM_CAST(wComBase*, This)); \
269 static ULONG WINPR_COM_CALL prefix##_Release(wIUnknown* This) \
271 return winpr_com_base_release(WINPR_COM_CAST(wComBase*, This)); \
276#define WINPR_COM_IUNKNOWN_THUNKS(prefix, iid) \
277 static HRESULT WINPR_COM_CALL prefix##_QueryInterface(wIUnknown* This, const IID* riid, \
280 return winpr_com_base_query(WINPR_COM_CAST(wComBase*, This), (iid), riid, ppvObject); \
282 WINPR_COM_REFCOUNT_THUNKS(prefix)
286#define WINPR_COM_IUNKNOWN_ENTRIES(prefix) \
287 { prefix##_QueryInterface, prefix##_AddRef, prefix##_Release }
void(* pfnwComBaseFree)(wComBase *object)
called when the last reference goes away: releases what the object holds and frees it
static BOOL winpr_com_guid_equal(const GUID *a, const GUID *b)
IsEqualGUID.
#define WINPR_COM_DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8)
defines a GUID constant visible in the including file only (nothing to link)
WINPR_API void winpr_com_base_init(wComBase *object, const char *className, const wIUnknownVtbl *vtbl, pfnwComBaseFree Free)
sets the vtable and the reference count to 1, the caller owns that first reference.
WINPR_API ULONG winpr_com_base_add_ref(wComBase *object)
AddRef of an object starting with a wComBase.
#define WINPR_COM_CXX_INTERFACE(name)
ends the declaration of a C++ interface name: only an implementation creates it and Release() frees i...
#define WINPR_COM_CALL
the calling convention of COM methods (STDMETHODCALLTYPE)
WINPR_API HRESULT winpr_com_base_query(wComBase *object, const IID *iid, const IID *riid, void **ppv)
QueryInterface of an object whose only interface is iid (nullptr: IUnknown only). On success *ppv is ...
WINPR_API ULONG winpr_com_base_release(wComBase *object)
Release of an object starting with a wComBase: calls its Free at 0.
the vtable of IUnknown, the first entries of every COM vtable